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Customer Questionnaire 



To help us in preparing new manuals, there is a questionnaire in the back of this manual. Your 
answers to the questions can assist in producing better, more useful manuals. Your feedback is 
our only way of knowing the validity of our manuals. Please complete the questionnaire and 
mail it — postage is already paid in the United States. Thank you. 
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System 35 Manual Reference 

The following block diagram shows manuals that are included in the System 35 Documentation 
scheme and suggested progression. Dotted-line borders indicate those manuals are available 
with specific options; solid borders indicate those manuals that are shipped with every System 
35. 
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Chapter Summaries 



Chapter 1. General Information. An introduction to the product and the manual. The pur- 
pose and differences of the two Assembly Language ROMs are explained. ROM installation 
procedures are given. A glossary is provided, along with a discussion of the syntactical forms 
used in the manual. 

Chapter 2. Getting Started. A general discussion of the assembly language system. A format 
for the creation of an assembly language program is presented. Topics such as modules, 
routines, and memory allocation are discussed, along with methods of using them effectively. 
Also discussed is the storage and retrieval of modules on mass storage. 

Chapter 3. The Processor and the Operating System. Necessary information on the struc- 
ture of the processor and the operating system is presented. Topics covered are: machine 
architecture, memory organization, data structures and arithmetic, and the machine instruc- 
tions. 

Chapter 4. Assembly Language Fundamentals. The basic statements and syntaxes used 
throughout the assembly language are discussed. Program entry, assembling, symbolic opera- 
tions, module creation, program and variable storage, and utilities are the topics covered. 

Chapter 5. Arithmetic. Arithmetic operations are reviewed and the arithmetic utilities are 
discussed. Floating point and BCD arithmetic are explained. 

Chapter 6. Communicating between Basic and Assembly Language. The techniques used 
to pass information to and from the assembly language programs are discussed. Calling assem- 
bly routines and passing parameters are presented, along with issues involved with using 
common. Applicable utilities are also discussed. 

Chapter 7. I/O Handling. The various techniques of handling the receiving and sending of 
information to peripheral devices is presented. Topics are: a review of I/O-type machine 
instructions, registers, applicable utilities, interrupts and interrupt service routines, 
handshake-type of I/O, direct memory access, and mass storage devices. 

Chapter 8. Debugging. Techniques for isolating and correcting logic problems in assembly 
programs are discussed. Included in the discussion are techniques for stepping through prog- 
rams, getting dumps, patching, and using the keyboard. 

Chapter 9. Errors and Error Processing. A discussion of Assembly Language ROM and 
other related errors, and what causes them. Included are methods for trapping errors and 
possible methods for correcting them. 
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Chapter X 

General Information 



Welcome to the world of assembly language programming on the 9835A/B. 

It is the design of the Assembly Development Read Only Memory (ROM) to help extend the 
capabilities of your 9835A/B by giving you greater control and speed through the use of 
machine instructions, pseudo-instructions, and extensions to the BASIC language. 

The assembly language system is provided to you as ROMs which plug into the drawers 
provided for that purpose in the 9835A/B. There are three physical ROMs, comprising two 
"logical" ROMs — 

• The Assembly Development ROM. Two physical ROMs. This ROM is always provided 
with an Execution ROM (together comprising HP product number 98339A), and the three 
ROMs as a unit constitute the assembly language system of the 9835A/B. 

• The Assembly Execution ROM, HP product number 98338A. One physical ROM. Since 
this ROM is an integral part of the assembly language system, the use of the capabilities in 
this ROM is incorporated into the discussions in this manual. Information on this ROM can 
be found separately in the Assembly Execution ROM manual (HP part number 09835- 
90082). 

It is assumed throughout this manual that you are familiar with the basic operation and lan- 
guage of the 9835A/B. It is also assumed that you are reasonably well-acquainted with at least 
one other assembly language. 
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Structure of the Manual 

It is the intent of this manual that you should be able to find between its covers everything you 
need to know to use the assembly language effectively. However, since assembly language 
programming is a complex topic, the manual relies a great deal on your past experience. Most 
of the information is in succinct presentations of a particular topic; it is not the intent to "teach" 
assembly language programming to someone not familiar with the topic. 

The major topics covered are: assembly language program creation (Chapter 2), the processor 
and relevant operating system constructs (Chapter 3), assembly language fundamentals (Chap- 
ter 4), arithmetic (Chapter 5), communications with BASIC (Chapter 6), I/O handling (Chap- 
ter 7), debugging tools (Chapter 8), errors and error processing (Chapter 9). Each topic, or 
chapter, has a summary at the beginning detailing the information to be presented therein. A 
compilation of these summaries can be found immediately preceding the Table of Contents. 

The manual is organized so that each topic can be covered completely within a given chapter. 
This approach was chosen over the strict syntactical or semantical treatment of the individual 
statements and instructions. As a consequence, you may find this difficult to use as a "quick 
reference" for syntax and meaning of the individual commands. 

To meet your needs for "quick reference" material, an Assembly Language System Quick 
Reference Manual (HP part number 09835-90081) is provided. In addition, you will find much 
of the information in this manual condensed and tabulated in the various appendices of this 
manual. 

A recommended method for using the manuals is to start with this one as your basic learning 
tool. Then you should be able to use the Quick Reference Manual effectively for all future 
reference. 



Purpose of the ROMs 



The Development ROM is used to write and debug assembly language programs on the 
9835A/B. The Execution ROM, provides the capability to load, run, and store assembled 
routines and modules. 

The Execution ROM can be used independently of the Development ROM. However, the 
Development ROM cannot be used without the Execution ROM. The latter's capabilities, there- 
fore, are considered in this manual as an inherent part of the Development ROM. Because of 
the overhead required by the debugging features provided by the Development ROM, pro- 
grams run more rapidly if the Execution ROM is used without the Development ROM. 



General Information 3 



ROM Installation 

Before assembly language programming can proceed, the ROMs must be in place. The installa- 
tion is a simple process. 

There are several ROM drawers for the computer: one on the right side of the machine and 
four in front. Each front drawer holds up to four ROMs; the side drawer holds up to fourteen. 
ROMs may be placed in any ROM slot in any drawer. 





Assembly Language System ROMs 

To add the ROMs, turn off the computer and remove a ROM drawer (by pulling outwards on it 
until it is completely separated from the computer). Insert the ROMs, one at a time, following 
this procedure: you should orient the ROM so that its label reads the same way as the others in 
the drawer (with the bottom of the lettering toward the "front" of the drawer). Then insert it 
vertically in one of the unused slots. Make sure that it slides in all the way to the bottom of the 
connector. There are small raised ribs on both sides of each ROM which will fit into recesses in 
the slot; if the ribs don't fit, you have not oriented the ROM correctly. 

After inserting both ROMs, re-insert the drawer in the machine (by pushing on it until it is flush 
with the outside cover of the machine). With this done, you are now ready to begin writing 
assembly language programs. 
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Figure 1. Installing the Development ROM 
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Buzzwords 

During the course of the discussions in this manual, words and phrases are used which are in 
common circulation among those who are familiar with assembly languages. While the mean- 
ing of most are either well-known, or are deducible from the context, there are a few which may 
be unfamiliar, or unique to the 9835A/B assembly language, or are variable from one assem- 
bly language to the next and thus need to be defined for this one. They are — 

assembled location — a reference to a location in memory which may be specified in one 
of the following forms — 

{symbol} [ = {numeric expression} ] 
{expression} [ , {numeric expression} ] 

where: 

{symbol} is an assembly location. It may be either a label for a particular machine instruc- 
tion (in which case the address of the associated instruction is used), or an assembler- 
defined symbol (in which case the associated absolute address is used), or a symbol 
defined by an EQU instruction (described in the "Symbolic Operations" of Chapter 4). 

{expression} may be a numeric expression or a string expression. If numeric, a decimal 
calculation is performed and the result is interpreted as an octal value; if the result is not 
an octal representation or an integer, an error results. If a string expression is used, the 
string must be interpretable as either an octal integer constant or a known assembly 
symbol (see {symbol} above). 

{numeric expression} serves as a decimal offset from the given label or constant. 

byte — a group of 8 binary digits (bits). 

busy bits — each variable located in the BASIC value or common areas has associated 
with it two bits: a "read" busy bit, and a "write" busy bit. When a busy bit is set, all 
attempts to perform the associated function on that variable are locked out. When a busy 
bit is cleared, the function may be performed on the variable. 

conditional assembly — an assignation that certain portions of a module are not to be 
assembled unless a condition has been set. The portions begin with any of the IFA through 
IFH, and IFP, pseudo-instructions, and end with the next XIF pseudo-instruction. IFA 
uses the A-condition as a test, and so on. The conditions are set by the statement assem- 
bling the module (lASSEMBLE). 
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interrupt service routine (ISR) — an assembly language routine intended to perform a 
certain action, or set of actions, when the computer receives a request from an external 
device. An "active" ISR is one which is currently enabled for a given device. 

mass storage unit specifier (msus) — a single word corresponding to the BASIC lan- 
guage mass storage unit specifier as described in either the 9835A/B Operating and 
Programming Manual — HP part number 09835-90000 — or the Mass Storage 
Techniques Manual — HP part number 09835-90070. An msus has the following struc- 
ture — 



Unit 
Number 


HPIB 
Address 


Device 
Type^ 


Select 
Code 


1 1 1 
1 1 1 


1 1 
1 1 


1 1 1 1 
1 1 1 1 


1 1 1 
1 1 1 



15 14 13 12 11 10 9 8 



1 Bit 



An msus can designate the current default as its mass storage device (meaning it will use 
the device indicated by the last MASS STORAGE IS statement executed). This is desig- 
nated by having the msus be all ones (i.e., equal to - 1). 

object module — a section of assembled code stored in the particular region of memory 
set aside for it. Though the source module for the object code may no longer be resident in 
memory, when created, the module was delimited by certain pseudo-instructions (NAM 
and END) and is referenced by the name given to it by the NAM pseudo-instruction. 

octal expression — a numeric expression which, when displayed or printed, appears as 
an octal (base-8) number. Within arithmetic operations, it has a decimal value (base-10). 
Thus, the value 178 will appear as 17 (representing the value 15io), but if arithmetic was 
performed on it, it would act as if it were 17io. All octal expressions are necessarily 
integers in the range of to 1777778. 

source module — a section of assembly language source code beginning with a NAM 
pseudo-instruction and ending with the END pseudo-instruction. 

word — two bytes; a group of 16 binary digits (bits). 



1 The device type is the ASCII code for the type minus 1008. 
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Fundamental Syntax 



The syntax conventions used in this manual are those used in the Operating and Programming 
Manual for the 9835A/B — 

All syntax items displayed in dot matrix form should be pro- 
grammed as shown. 

[ ] Items contained in brackets are optional items. 

Ellipses mean that the previous item may be repeated 
indefinitely. 

In addition, the following convention is employed throughout the Assembly Language series of 
manuals — 

{ } Items contained in braces are syntax items considered as a 
unit. The names inside are usually descriptive of the function 
intended for that item. Whenever an item enclosed in braces 
appears in the text, the notation refers to the same notation 
within an earlier syntax. 
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Chapter £t 

Getting Started 



Summary; This chapter contains a general discussion of the assembly language sys- 
tem. A format for the creation of an assembly language program is presented. Topics 
such as modules, routines, and memory allocation are discussed, along with methods of 
using them effectively. Also discussed is the storage and retrieval of modules on mass 
storage. 

The thing to remember about the assembly language system is that it has been thoroughly 
integrated into the operating system of the 9835A/B. Once the ROMs have been installed, you 
are able immediately to begin programming in assembly language. In addition, you have the 
capability to load and store your programs on mass storage, to assemble them separately or 
leave them in source form, to execute them from BASIC and pass BASIC variables to them, 
and to debug them, including a full pausing and stepping capability. 

Developing Routines for Later Use 

Most assembly language programs are written with the intent that they will be used many times, 
not just at the time they are written. It is for just such program development that the full 
capabilities of the assembly language system come into play. The development comes in 
several stages. Each stage has its unique requirements and the tools to meet those require- 
ments. 

The first stage is creation of the source program. This is achieved by the use of the editing 
capabilities of the 9835 A/ B. Additionally, the basic mass storage capabilities of the computer 
can be used. 

The second stage is the creation of the object (or machine) code. This requires not only an 
assembly of the source, but the ability to allocate special locations in memory to hold the newly 
created object code. 

The third stage is the validation of the routines as written, commonly known as "debugging". 
This is enabled by calls from a BASIC driver, followed by application of various debugging 
tools provided by the assembly system. The capabilities to pause and step a program have been 
extended to assembly language instructions to assist this process. 
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The fourth stage is to store away the ciebugged object code so that it may be used at a later 
time. A special mass storage statement is provided by the assembly language system. This 
statement stores object code into a special assembly file. 

Finally, the end-user of the routines must be able to retrieve the object code from mass storage 
as it is needed. He also must be able to access the routines from BASIC programs. Both these 
needs are met with the Execution ROM, so the capabilities are not only provided, but they are 
provided independent of the program development capabilities located in the Development 
ROM. 

Each of the topics involved in these stages is discussed at length in this manual. 

Figure 2 presents a graphical presentation of this overview. 
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Figure 2. Overview of Assembly Language Routine Development Process 
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Overview 



At this point, there are three fundamental structures to be explained: programs, modules, and 
routines. 

A program is the set of source statements from which the object (or machine) code is gener- 
ated. The assembly source statements are extensions to the BASIC language which is used in 
the 9835A/B. The statements themselves are stored in the machine as part of the BASIC 
program in which they reside. At some point, you must take the assembly source statements 
and assemble them into object code, in order that they can be run. The object code is stored in 
a specified location in the machine. 

A module is a subset of the object code. It is a means of separating and identifying parts of the 
code so that those parts may be used individually (as in mass storage operations). There may 
be any number of modules present at any one time, limited only by the amount of memory 
allocated for object code. 

A routine is a "callable" section of a module. It is analogous to the subprogram in BASIC. It 
has a named entry point, possibly a parameter list, and (if programmed correctly) a return. A 
module may contain any number of routines, again limited only by the amount of memory 
allocated to hold the object code. 

In short, the usefulness of each structure is as follows — 

• Programs contain assembly language source code. 

• Modules contain object code to be loaded from or stored on mass storage. 

• Routines are executable sections of object code. 

Program Creation 

The first matter which is likely to concern you about the assembly language system is how to 
create an assembly language program. 

In general, the process of creating an assembly language subprogram consists of the following 
steps — 

1. Enter and store the source code (program). 

2. Create an area in memory which will ultimately contain the object code. 
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3. Assemble the source code into object code, storing the latter into the area of memory set 
aside for it. 

4. Execute the object code (routines) from BASIC "drivers". 

Each of these steps will be discussed at length in the pages of this manual, along with a number 
of not-so-incidental side-topics (such as "debugging" techniques). The purpose of this short 
section is to give you an impression of the general procedure through which an assembly 
language subprogram is created. 

As an example to use to demonstrate the process, suppose the following task has been assigned 
to you — 

Requirement: Write an assembly language subprogram which takes two integer 
values and multiplies them together as integers. If the result overflows the range of 
an integer (— 32 768 to + 32 767), then the subprogram should return the same 
error as the system would (i.e., error number 20). 

With this task in hand, suppose that you have completed a programming analysis that suggests 
that the following assembly language source code would fulfill the subprogram's functions — ^ 
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jr e: 


:: i 


put 1 
put.;::; 
tput 


' 


I NT 
I NT- 
INT 








1 1. 1 f 


]y: 


Llifl 


:=: T i--, 
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1 The fact that it is rarely possible to create a running program at this stage should not get in the way of accepting the example. 
Usually there is debugging involved in later stages. 



Getting Started 11 



Now that the routine has been developed, it is necessary to get it into the memory of the 
machine as a program. This is done by preceding each and every assembly language statement 
with the keyword ISOURCE and entering it as a program line. The process of entering (with the 
keyword included) is the same as with any other BASIC statement — so you can use EDIT or 
AUTO and the (^^ key in the same way you normally enter any BASIC statement. (This 
process is fully described in the "Program Entry" section of this chapter.) 

The final result of entering the routine would look something like — 



10 


ISuUhlCE 




HflM 


Mulfipl ica 




! I 


Beginning of module 


pwi 


isuuf;:ce 




EXT 


Error exit 


, ue- 


■ vi 


.lue,Put value 1 Utilities 


■'.'} k''j 


ISOUFiCE 


Integers 


: i;;SS 


i;::! 




r Si 


oraxie area. fVjr i ntecier-ii:. ci-eatecj 


40 


ISOUI^CE 




SUB 






I I r 


\d i cat es i~-ri t- r-;,.' po i n t- F'o 1 1 ch,.!::;;. 


5Q 


ISOUKICE 


Input 1 ;; 


I NT 






! Ir 


id i cat es " i nt dinger Fivi.!-;-! met ers are 


60 


ISulJFilCE 


I nput 2 ;; 


IHT 






1 


passed in the order given by the 


70 


ISOURCE 
ISOURCE 


Oi-!tput ;; 

Multiply 


IHT 
: L..IJR 


^,T|...,, ....,^.,...„ 




■ Rr 


t- i.+a 1 e n t ry po i n t- ■: r\a. w el M u 1 1 i |: j 1 y 


90 


ISOURCE 




LDE 


-Input 1 




■ 


rout 1 rie- l:::M~;-g i ns b;,.^ f et c h i i-iq .3.r t i...i-=i 


100 


ISOURCE 




JSM 


Get uaJue 






^■Si.lue of the input panameters 


110 


ISOURCE 




LDR 


=:Integers-i- 


1 




from EflSIC a.nd storing them when 


130 


ISOURCE 
ISOURCE 




LDE 
JSM 


-I nput 2 
Get ■vS.lue 




i 


the routine can use them 


140 


ISOURCE 




LDR 


Integers 




Tr 


■en it ]r^a.ds the values into the 


150 


ISOURCE 




LDB 


Integers-!-! 






ar i t i"!met i c ac c i..imu 1 at or and 


160 


ISOURCE 




MPS' 








f 1 na i 1 y mu 1 1. i p 1 i es t l-iern 


170 
180 


ISOURCE 
ISOURCE 




CME 


*-i-2 




H 


" '':"' ^ :....! ?r .; ::^!i':'V ■'.'■ f ^... I f.,. ^f!':-':'^'ft 


190 


ISOURCE 




SZE 


■¥■■+■3 






■i r, the B i-eg 1 ster i.ii-n;;:n i t. :;:;i-.oi-i 1 d hf 


i:00 


ISOURCE 




LDR 


=2B 






and if vt isn't. Error 20 is select 


210 
22:0 


ISOURCE 

isoufice: 




JSM 
S'T'H 


Error exit 




1 1 i 


and the routine is aborted 


230 


ISOURCE 




LDR 


== Integers 




T\ 


le product is then returned to th 


2^^10 
2!5f::i 


ISOURCE 
ISOURCE 




LDE 


^Output 
Put Ma.lue 






output variable in BASIC listed 
among the arguments 


260 


ISOURCE 




IJP"!" 


i 




Ne 


-re finished, so return to EfiSIC 



This source code demonstrates the three critical items in assembly subprograms. First, a routine 
has to be part of a module; modules are delimited with the NAM and END pseudo-instructions 
(see lines 10 and 270 in the source). Second, a routine has to have an entry point; this consists 
of a SUB pseudo-instruction (see line 40), any parameters (see lines 50 through 70), and a 
name (the label used on the first machine instruction following the SUB, see line 80). Finally, a 
routine must be able to return to the BASIC program which called it; this is accomplished with 
the RET 1 instruction (see line 260). 



The NAM, END, and SUB pseudo-instructions are discussed in Chapter 4. The RET 1 instruc- 
tion is discussed in Chapter 3. 
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The next three steps in program creation are each satisfied with BASIC-executable statements. 
Creation of a storage area for the object code for the program (which can be estimated at less 
than 40 words; there is essentially one word of object code per line of source) is accomplished 
by programming the statement — 



(The ICOM statement is fully discussed in the "Setting Aside Memory" section of this chapter. ) 

This can be followed in the same program by an instruction to assemble the source code into 
object code — 



(The lASSEMBLE statement is fully discussed in Chapter 4.) 

If the assembly is successful (and it will be in this example), then the routine can be called and 
used as desired. A typical call looks like — 









(The ICALL statement is fully discussed in Chapter 6.] 
Thus, the final result could easily be — 
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It isn't necessary that a program be assembled in every BASIC program which uses it. Object 
code can be stored on mass storage with a statement like — 



So if the example were instead made to read — 
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the object code is consequently stored into the file "MULT". 



Later programs can retrieve the object code for use, such as in the following program — 



JJiJi'i 4!; 



Firrav<Subscri iot 



(Both ISTORE and ILOAD are discussed in the "Retrieving and Storing Modules" section of 
this chapter.) 

Program Entry 

The assembly language source statement is an extension to the BASIC language used in the 
9835A/B. This means that each assembly language statement is entered using a 
"keyword" ■ — in this case ISOURCE — as a message to the operating system that the line is an 
assembly language statement. 

By looking at an example, you can see what is meant — 



= 10 



iiiy i,...fc. ! £'■ 



sOURCE hJ'-iD 



Lines 10, 20, 30, and 70, are all recognizable as BASIC statements. The keywords they 
use — LET, PRINT, and END — direct that certain actions take place. Lines 40, 50, and 60, 
are all assembly language statements; this was indicated by the ISOURCE keyword used in 
these lines. 



Entering assembly language statements, by using the ISOURCE keyword, is thereby the same 
process as entering other types of BASIC statements. You may use all of the system editing 
features that you are used to using in the creation of BASIC programs — EDIT, AUTO, etc. You 
store each line with the (^^ key, as you would any other BASIC line. 
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Also, assembly lines do not have to be in any special place in the BASIC program. The above 
example could be re-arranged as follows — 



iPPi- 



LET 
I SCA. 



Thus, you are free to enter your assembly statements anywhere in your BASIC program. But, 
you may ask, what is the effect of spreading them out like this? The answer is, simply, none. 
When the time comes to use them, assembly statements and BASIC statements are separated 
by the operating system and treated differently. 

When the BASIC program is run, ONLY the BASIC statements are executed. The ISOURCE 
statements are ignored, and, as you will be shown in Chapter 4, when the assembly language 
lines are assembled, the BASIC statements are ignored. A way to consider it is that there are 
two programs in one — BASIC'S and the assembler's. So you can envision the example above 
as being this way — 

BASIC ASSEMBLER 




You should note, then, that ISOURCE statements are not "executable" in the usual BASIC 
sense. Their location in the program does not indicate the place where they will be executed. 
Assembly instructions are not executed until a routine is "called"; this is discussed in detail in 
Chapter 4. 

Now that it has been said that the two types of statements can be thoroughly intermixed, it 
should also be said that the practice is not recommended. As a good programming practice — 
i.e., for readability and to preserve the self-documenting features of BASIC — it is recom- 
mended that assembly statements be collected together and placed in one spot in the program. 

The first example is a recommended practice over the second, even though the second is 
permissible. 
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Other Extensions 

In addition to the ISOURCE statement, there are a number of other BASIC language exten- 
sions provided by the assembly languge system. Unlike the ISOURCE statement, they are 
"executable", and their appearances are part of the BASIC lines (as distinguished from the 
assembler's). Where they appear is where the action associated with them is taken. This is 
identical to the way the other BASIC statements perform. The statements involved are — 

lASSEMBLE 

IBREAK 

ICALL 

ICHANGE 

ICOM 

IDELETE 

IDUMP 

ILOAD 

INORMAL 

IPAUSE OFF 

IPAUSE ON 

ISTORE 

OFF INT 

ON INT 

Also provided are four numeric functions — 

DECIMAL 
lADR 
IMEM 
OCTAL 

The functions can be used wherever numeric functions in general may be used. 

All of these statements (except ICOM and ISOURCE) and the functions are available to you as 
live keyboard operations as well as programmable statements. A full discussion of each of the 
statements and functions can be found within this manual. 
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Modules, Routines, and Such 

There are three basic activities associated with using assembled modules and routines. First, 
there is the need to retrieve them from wherever they may be stored (including providing a 
place for them to be kept while they are resident in the memory of the machine). Second, there 
is the actual execution of the routines. And third, there is the occasional requirement to store, 
or re-store a module on mass storage (including, perhaps, the need to free up the space in 
memory it previously occupied). 

Names 

Routines, modules, and files all have names. The names given them may or may not bear some 
significance to one another; that depends upon you and the way that you name things. 

Conventions for the naming of files and methods of general file manipulation can be found in 
the Operating and Programming Manual and in the Mass Storage Techniques Manucil. The 
conventions are not any different than for files in general. 

Names for modules are assigned with the creation of the source. In the assembly language 
source code, you have a NAM pseudo-instruction. This serves two purposes — to designate the 
beginning of the module and to assign the module a name. All of the assembly source state- 
ments which follow the NAM are in that module until an END pseudo-instruction is encoun- 
tered. Thus, recalling the previous example — 



SfiL 



All of the ISOURCE statements between lines 20 and 60 (in this case, just the one) form the 
module called "Example". The formal syntaxes of these pseudo-instructions are — 

NhM {module name} 
END {module name} 



{module name} is a symbol which becomes the name of the module. It follows the same rules as 
names in BASIC: up to fifteen characters; starts with a capital letter; followed by only non- 
capital letters, numbers, or the underscore character. 
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The {module name} in the END statement must correspond to the {module name} of the NAM 
statement or an assembly error ("EN") results. 

You may have any number of modules in your source code. Each module begins with a NAM 
and ends with an END pseudo-instruction as above. 
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ICALL routine 2 
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ICALL routine 5 



ICALL routine 6 



Figure 3. Overview of Routines and Modules. 



Survey of Modules and Routines 

To sketch the functional relationships of modules and routines, please refer to Figure 3 above. 



Modules are stored in files and may be retrieved and placed in memory using the "ILOAD" 
command. When the ILOAD command is executed, all of the modules in the file are loaded into 
the memory. Note that many files can be loaded, with many modules each, with all of the 
modules able to remain resident in the memory. 
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Alternatively, modules which are already in memory may be stored into a single file using the 
"ISTORE" command. When the ISTORE command is executed, the designated modules are 
stored into an "option ROM" (OPRM) type of file (on tape cartridges) or an "Assembly" 
(ASMB) type of file (on non-tape mass storage media). After storage, the modules are still in 
memory. They maybe removed (i.e., the space they occupy in memory is "freed up") by using 
the "IDELETE" command. 

The area of memory where the modules are stored is called the "ICOM region". It is a particu- 
lar contiguous area which must be large enough to hold all of the object code you wish to have 
resident in the memory at any one time. 

Each module contains one or more routines. Your access to the routines is through the ICALL 
statement, which is very similar to the CALL statement used for BASIC subprograms. The 
ICALL statement may have arguments which you need to "pass" (send down) to the routine 
itself. What these arguments, if any, may be, and what meaning they hold depends upon what 
you have in mind for that routine. There are corresponding items in the assembly source code; 
these are discussed in Chapter 6. 

Setting Aside Memory 

As indicated by Figure 3, you cannot load a module until there is an ICOM region into which to 
load it. Neither can you assemble your source code into object code unless there is an ICOM 
region into which the object code can go. 

The statement to use to create an ICOM region is — 

I C Oil {size} 

where {size} is an integer constant indicating the number of words to be used to form the ICOM 
region. The maximum size is 32 718 words. 

The ICOM statement is a "declaration", that is, it is not executable, but rather is used when 
assignment of memory takes place just before a program is run. This is similar to a DIM or COM 
statement. As with a DIM or COM statement, the statement cannot be executed from the 
keyboard. 

Once created, the ICOM region remains in existence until it is explicitly destroyed. But it is 
possible to change the size by using another ICOM statement. 
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The order in which modules appear in the ICOM region is determined by the order in which 
they are loaded using the ILOAD statement discussed in the next section or are created by the 
lASSEMBLE statement discussed in the next chapter. 

In most cases, the space which is freed up by reducing the size of the ICOM region is returned to 
your available memory space. Sometimes, however, it is not returned, this being caused by the 
status of the common area allocated in memory, or by other option ROMs. The space is 
returned whenever — 

• There is no common area assigned (with the COM statement); and, 

• The requirements of another option ROM do not interfere. 

There may be any number of ICOM statements in a program. The current size of the ICOM 
region is determined by the last one which appears in the program when the [^ key is pressed 
(or the command RUN is executed). 

For example, suppose you have a program with the following statements in it — 



Upon pressing (^, the ICOM region would be 2 000 words long. This is because line 610 is 
the final ICOM appearance. 

The region continues to exist even if you load in another program which contains no ICOM 
statements. All ICOM statements must appear in the main program, not in any subprogram. 

ICOM statements in a program must appear before any COM statement. This is to insure that 
the ICOM region will be allocated before the common is allocated. 
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There are three ways to eliminate the ICOM region — 

• Execute SCRATCH A 

• Execute ICOM in a program. 

• Turn off the machine. 

After any of these actions, the region is no longer in existence. If there are any modules in the 
region, they disappear as well. If any of those modules contain an active interrupt service 
routine, you get an error (number 193) if you try to eliminate the region using ICOM 0. If any of 
your routines provided to other users contain active ISRs, your documentation for the routine 
should warn the users of that fact so they can avoid this error. 

The ICOM procedure can be used to assure that all previous modules are deleted. For 
example, the following sequence — 






assures that an ICOM region of 2 000 words is in existence at the running of the program, and 
one completely clear of any previously loaded modules. 

When you are altering the size of the ICOM region, the new size specified becomes the size of 
the region from the moment of running the program. If the size being requested is larger than 
that which already exists, the additional space needed is requested from the operating system. 
If the space is available, everything proceeds uneventfully. If the space is not available, an error 
(number 2) results. To make the space available, one of the following procedures must be 
followed — 

• Execute SCRATCH A. 

• Execute SCRATCH C. 

Each procedure has its separate effects, and the course selected should be determined by your 
circumstances at the time. Consult the Operating and Programming Manual for details on the 
other effects of each of these commands. 
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If the size being requested is smaller, modules are deleted if they no longer fit into the smaller 
region. For example, suppose the following situation existed — 



■"new" ICOM size^ 



'old" ICOM size 



module 
A 


module 
B 


1 

module 

C 
1 


module 
D 


module 

E 



Upon compilation of the new ICOM statement, the modules E, D, and C are deleted. None of 
those modules may contain an active interrupt service routine or an error results (number 193). 

Retrieving and Storing Modules 

Modules are stored in files on mass storage media as Option ROM (OPRM) or Assembly 
(ASMB) types of files. On tape media, they are stored in the OPRM type and on non-tape 
media they are stored in the ASMB type. In this case, the two file types are equivalent.^ 

To retrieve a module, or modules, from mass storage, identify the file name of the file contain- 
ing the module. Combine the name with the mass storage unit specifier^ of the device to form a 
file specifier. Then execute the statement — 

{file specifier} 

This retrieves ALL the modules in the file and stores them in the ICOM region. 

If there are modules already loaded in the ICOM region, these additional modules are added to 
them, (NOT written over them). If an existing module in the ICOM area has the same name as 
one of the modules being loaded, the existing module is deleted and the loaded version takes 
its place. 

If you do not want all the modules in a given file, you can purge the unwanted ones from the 
ICOM region using the IDELETE statement — 

i LjIILIITE {module name} [, {module name} [,...] ] 



1 OPRM-type files may be created by other option ROMs for their particular purposes. In those cases, the contents are entirely 
different. 

2 Not to be confused with the single-word msus described in Chapter 1. This form is used by BASIC'S Mass Storage statements 
(see the Operating and Programming Manual or Mass Storage Techniques Manual). 
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For example, if you had loaded a file which had the routines Larry, Pat, Ed, and Piper, and you 
want to keep only Larry, then you execute the statements — 



or, more simply — 



Deletions do not have to be done immediately after loading. They can be done at any time. 
After the IDELETE has been executed, the portion of the ICOM region which the module 
previously occupied is made available for use in loading other modules. The space is NOT 
returned to the generally available memory; that action is done with an ICOM statement with a 
smaller size. 

Whenever a module is deleted, other modules are moved, as necessary, to take up any slack 
space in the ICOM region. This is done so that all of the free space in the region is at the end. If 
a module is being deleted, or being moved as above, and it contains an active interrupt service 
routine, an error results (number 193). 

If you desire at any time to delete all of the modules in your ICOM region, you can do so by 
executing either of the following statements — 



Sometimes you may desire to move modules in the opposite direction — from memory to mass 
storage. This is done with the ISTORE statement. The statement has the form — 

{module name} [, {module name} [,...]] ; {file specifier} 

A {module name} must be the name of a module currently stored in the ICOM region. Upon 
execution of the statement, a file with the name and mass storage unit specifier given in the {file 
specifier} is created and the modules are stored in the file, in the order listed. 

The file created by an ISTORE statement is an OPRM or ASMB type, as appropriate to the 
medium involved. It can then be used in ILOAD statements at a later time. 
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In the case that you might want to store all of the routines currently in the ICOM region into a 
particular file, you can use either of the following statements — 

{file specifier} 
{file specifier} 
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Chapter O 

The Processor and 
the Operating System 



Summary: This chapter contains the necessary information on the structure of the 
processor and the operating system. Topics covered are: machine architecture, memory 
organization, data structures, and the machine instructions. 



Before proceeding to the actual assembly language, it is useful to discuss the processor and 
operating system with which you are dealing. This chapter discusses various concepts related to 
the processor, the machine instruction set, the operating system organization, and data struc- 
tures. 

Machine Architecture 

The 9835A/B is developed around a set of processors called a "hybrid". There are actually 
three processors — the Binary Processor Chip (BPC), the Input-Output Controller (IOC), and 
the Extended Math Chip (EMC). Each has its own set of instructions, but all three work in 
conjunction. It is not necessary in using the assembly system that you know on which chip a 
particular instruction resides. In the presentation of the instruction set — and for all practical 
purposes while working with the computer — no distinction need be made between the proces- 
sors, and the entire instruction set may be considered as being resident on a single processor. 

In addition to the processors, the hybrid also contains an I/O bus which is controlled by certain 
instructions. The I/O bus has an "address" part and a "data" part. Some of the instructions (it 
is indicated which ones) cause an "input cycle" to occur on the bus, which means that an 
address is given to the address part of the bus, and the data which appears on the data part is 
considered to be input. Other instructions cause an "output cycle", which means that the data 
is to be output to the given "address". 

Figure 4 is a graphical representation of this architecture. 
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Figure 4. Generalized Machine Architecture 

Registers 

The memory locations in the machine are addressed from to 1777778. There are 32 memory 
locations which are addressed as if they were part of the computer read /write memory, but 
actually are part of the processor. These locations are called "internal registers". Each register 
has a specific location and has been given a name. As you will learn in "Symbolic Operations" 
(Chapter 4), these names have been reserved and cannot be redefined while using the assem- 
bly system. 

The internal registers are — 





Address 






Name 


(Octal) 


Description 


A 





Arithmetic accumulator 


Ar2 


20-23 


BCD arithmetic accumulator 


B 


1 


Arithmetic accumulator 


C 


16 


Stack pointer 


Cb 


13 


Block bit for byte pointer in C (use most significant bit only) 


D 


17 


Stack pointer 


Db 


13 


Block bit for byte pointer in D (use second most significant bit only) 


Dmac 


15 


DMA count register 


Dmama 


14 


DMA memory address register 


Dmapa 


13 


DMA peripheral address register (use lower 4 bits only) 


P 


2 


Program counter 


Pa 


11 


Peripheral address register (use lower 4 bits only) 


R 


3 


Return stack pointer 


R4 


4 






R5 
R6 


5 
6 




■ I/O (Input/ Output) registers 


R7 


7 






Se 


24 


c 


>hift-extend register 
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Figure 5 is a map of where these registers lie. In addition to these registers, the addresses 258 
through SVs are also registers, but are not (except for a few isolated cases) used in assembly 
programming. 





A 




B 




P 




R 




R4 




R5 




R6 




R7 




(reserved) 


Cb\ 


1 ; Pa ; 


> 


V 


(reserved) 






1 1 Qm.apa | 


Db- 


^ 


Dmama 






Dmac 




C 




D 




Ar2 




Se 




(reserved) 



address 

1 
2 
3 
4 
5 
6 
7 
10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 
24 
25 



37 



Figure 5. Map of Lowest Memory 

All of these registers can be referenced either by their names or by their actual addresses. The 
two methods are equivalent, though reference by name is recommended as a programming 
practice. 



In addition to the above internal registers, there are some "external" registers which reside in 
the computer read /write memory. They are — 



Name 


Address 
(octal) 


Description 


Arl 


177770-177773 


BCD arithmetic accumulator 


Base page 


177620-177701 


Base page temporary area (50 words) 


Oper_l 


177702 


Arithmetic utility operand address registers 


Oper 2 


177703 




Result 


\llim 


Arithmetic utility result address register 
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General Memory Organization 

In order to find your way around the machine effectively, you should be aware of where things 
are stored in memory. Occasionally these areas can become considerations in your 
programming. 

First in the memory come the internal registers. They were discussed above. 

Next in the memory comes the ICOM area. The starting location is dependent upon system 
needs, but is always at least 4l8. The size of the ICOM region depends upon the size designated 
by the ICOM statement. Its maximum ending address is 777568. This is the reason for the 
limitation on the size in the ICOM statement. 

Next in the memory comes the area reserved for the system to store programs and the like. This 
area extends from the end of the ICOM region to 1776178. 

This area is followed by the registers in the read /write memory (see the list in the previous 
section) with a number of interspersed system-reserved areas. 

Figure 6 is a graphical presentation of this organization. 

The immediately addressable memory consists of 65 536 words, which is all that can be ad- 
dressed by a 16-bit word (the basic unit of memory in the system). Note that the memory is 
divided into two blocks — an "upper" block and a "lower" one. This distinction between 
blocks becomes significant when addressing individual bytes in memory. 

Protected Memory 

All of the reserved areas mentioned above are known as "protected memory". To give some 
measure of security to the operating system, it is advised that no attempt should be made to 
write or branch into these areas. 

Access to certain portions of protected memory (e.g., BASIC variables) is provided by utilities 
within the assembly system. The user should access those areas only through the utilities. 

Some measure of protection against access into these areas is provided during debugging. See 
Chapter 8 for a discussion of how this is done and the extent of the protection provided. 
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37 

40 



CPU registers 



(reserved) 



.„ . . (at least 1 word) 



max =77756- 
77777 

100000 



user data 
(ICOM area) 



(reserved) 
(at least 17io words) 




i starting address 

■\ dependent upon 

system needs 



ending address 
dependent upon 
starting address, 
length of ICOM, 
and system needs J 





(reserved) 


177617 




177620 






Base_page 


177701 




177702 


Oper_1 


177703 


Oper_2 


177704 


Result 


177705 






(reserved) 


177767 




177770 






Art 


177773 




177774 






(reserved) 


177777 





lower block 



upper block 



Figure 6. Memory Map 



Base and Current Page 



A concept that occasionally arises during discussion of the instructions and the assembler is that 
of the "page", the "base" and "current" pages in particular. 



A page is 1 024 words of memory. 
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The "base" page is a wrap-around page. It consists of the upper half of the last page in the 
machine (addresses 1770008 to 1777778) and the lower half of the zero page (addresses to 
Ills). This is the same as a page which runs from - 512 to + 511, effectively "wrapping 
around" address 0. 

During execution, the program counter (P) points to the address of the current instruction. The 
"current" page is those 1 024 words of memory centered upon the current instruction. There- 
fore, the current page is a continually changing page, extending from (P)— 512 to (P)+ 511. 

Data Structures 

It is common to access BASIC variables from an assembly language routine then retrieve the 
contents, manipulate them, or alter them. To be effective at it, you should be aware of how 
BASIC stores a value in each of its data types. 

There are four data types in BASIC: full-precision numeric values, short-precision numeric 
values, integers, and strings. Each is stored in its own unique structure. 

Integers 

The simplest of the types is the integer. An integer consists of a single word. Values between 
- 32 768 and + 32 767 can be stored in the word. Negative values are stored in two's com- 
plement form. An integer looks like — 

15 14 ... Bit 



Value 



^ 



Sign Bit 



Strings 



Strings are the next simplest structure. A string is a succession of bytes, one character to a byte. 
A string may be of variable length. To be able to designate the length, the string is preceded by 
a word which contains the number of bytes in the string. 

If a string has an odd number of bytes in it, then the left-over byte in the word containing the 
last character of the string is wasted. A typical string of length n looks like — 



n(length) 


bytel 


byte 2 


byte 3 


byte 4 


bytes 


bytes 


r ■ ; 


byte n-2 


byte n-1 


byte n 


- 
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Full-Precision Numbers 

Full-precision numeric values are stored as 12-digit, BCD (Binary Coded Decimal), floating 
point numbers. They occupy four words each. The first word contains the sign of the exponent, 
a two's-complement 10-bit exponent, and the sign of the mantissa. The other three words 
contain the twelve mantissa digits, 4 to each word. The words look like this — 



15 14 13 12 11 10 9 8 



1 Bit 



Expj 1 1 1 1 1 1 1 1 
Signi Exponent 


1 1 1 1 



Man 
Sign 


Di 

(most significant digit) 


D2 


Da 


D4 


Ds 


De 


D7 


Da 


D9 


Dio 


Dii 


Dl2 

(least significant) 



The exponent is always adjusted during arithmetic routines so that there is an implied decimal 
point following Di. Thus, every mantissa value looks like — 

Di . D2 Ds D4 Ds De D? Ds Dg Dio Dii D12 

Short-Precision Numbers 

Short-precision numeric values are stored as 6-digit, BCD floating point numbers. Unlike 
full-precision, they occupy two words each iristead of four. The first word contains a 7-bit 
exponent, the sign of the mantissa and the two most significant mantissa digits. The second 
word contains the remaining four mantissa digits. The words look like this — 



15 14 13 12 


11 10 9 


8 


7 


6 5 


4 


3 


2 1 





Expl 11111 
Signl Exponent 


Man 
Sign 


1 1 1 
Di 


1 1 1 
D2 


D3 


D4 


Ds 


De 



As with full-precision, the exponent is stored in two's complement form and the implied deci- 
mal point follows Di. 



If you are unfamiliar with BCD arithmetic or need a refresher in floating point operations, it is 
suggested that you refer to Chapter 5. 
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Machine Instructions 

The machine instruction set underlying the assembly language system consists of 92 instruc- 
tions, divided into eleven groups. The groups are — 



Load/ Store 
Integer Math 
Branch 
Test/ Branch 

Test/ Alter/ Branch 

Shift-Rotate 

Logical 

Stack 
BCD Math 
I/O 
Miscellaneous 



Operations placing values into registers or memory. 

Operations involving integer arithmetic. 

Operations altering the execution sequence unconditionally. 

Operations altering the execution sequence, dependent upon 
some condition. 

Operations altering the execution sequence and a value, de- 
pendent upon some condition. 

Operations performing re-arrangments of the bits in the A or 
B register. 

Operations performing logical functions on the A or B regis- 
ters. 

Operations managing stacks. 

Operations involving BCD arithmetic. 

Operations specifically involving I/O operations. 

Some unclassifiable operations. 



Operands 

Most instructions require operands. These operands have general forms which they may assume. 

Many instructions contain an operand which is the address on which the function is to be 
performed. This {location} may be a constant (octal or decimal) or it may be a symbol. It also 
may be an expression containing any allowable combination of constants and symbols. For a 
full discussion of allowable expressions and symbols, and the "types" they are allowed to 
assume, consult "Symbolic Operations" in Chapter 4. 
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For example, note the operands in the following — 



A {location} may be either "relocatable" or "absolute" (see "Relocation" and "Symbolic 
Operations" in Chapter 4 for a full treatment of these types). If a relocatable {location} is used, 
the assembler generates machine code which uses "current page" addressing, and thus the 
{location} must be within — 512 words and +511 words of the instruction. If an absolute 
{location} is used, the assembler generates machine code which uses "base page" addressing 
(meaning it takes the address as an offset from location 0). 

An {address} is a {location} the same as above, except the intended location must be 
relocatable and within — 32 and + 31 words of the current instructions. 

A {register} may be specified either through its absolute address or by its pre-defined symbol. 
The permissible registers are those with addresses between and 7, inclusive. These are 
registers A, B, P, R, R4, R5, R6, and R7. 

A number of instructions are followed by a {value}, which is a numeric expression usually in the 
range of 1 through 16. This {value} frequently indicates the number of bits involved in the 
operation. For example — 



right-shifts the A register by 8 bits. 



NOTE 

Specifying the R4, R5, R6, or R7 registers (absolute loca- 
tions 4 through 7) in an instruction causes an "I/O bus 
cycle" to occur. Consult Chapter 7, "I/O Handling", for the 
proper use of these registers. 
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Indirect Addressing 

Some instructions may also employ "indirect addressing". This is indicated by including the 
optional indicator , I, such as — 



There is only one level of indirect addressing provided with the processor. Of course, if further 
levels are desired, it is possible to implement them on your own. Some flagging scheme could 
be adopted, for example. One approach could be to adopt the policy that the sign bit (bit 15) of 
a word would indicate further indirection, with the remaining bits being the value. In such an 
approach, a load accumulator instruction would become two instructions — 



Load/ Store Group 

This group of instructions allows transfers of data to take place. With the instructions below you 
can move information to and from the arithmetic accumulators (the A and B registers). You can 
also transfer the contents of one contiguous set of words in memory to another contiguous set. 



Instruction 



Description 



{location} [, I] 
{location} [,1] 
{location} [, I] 



{location} [, i] 



R {value} 



{value} 



Loads register A with the contents of the specified location. 

Loads register B with the contents of the specified location. 

Stores the contents of the A register into the specified loca- 
tion. 

Stores the contents of the B register into the specified loca- 
tion. 

Clears (zeroes out) the specified number of words, beginning 
at the location specified by the A register, {value} must be an 
integer between 1 and 16. 

Transfers the specified number of words, from one location to 
another. The starting address of the location being transfer- 
red from must be stored in the A register. The starting ad- 
dress of the location being transferred to must be stored in 
the B register, {value} must be an integer between 1 and 16. 
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Integer Math Group 

This group of instructions allows you to perform fundamental arithmetic operations on the 
contents of the arithmetic accumulators (the A and B registers). 



Instruction 



Description 



{location} [,, I] 



{location} [, I] 



Adds the contents of the specified location to the contents of 
the A register, leaving the result in A. If a carry occurs, the 
Extend flag is set in the processor. If an overflow occurs (a 
carry from bits 14 or 15, but not both), the Overflow flag is set 
in the processor. 

Adds the contents of the specified location to the contents of 
the B register, leaving the result in B. If a carry occurs, the 
Extend flag is set in the processor. If an overflow occurs (a 
carry from bits 14 or 15, but not both), the Overflow flag is set 
in the processor. 

Performs a two's complement of the A register (i.e., one's 
complement, incremented by 1). If a carry occurs, the Extend 
flag in the processor is set. If an overflow occurs (a carry from 
bits 14 or 15, but not both), the Overflow flag in the proces- 
sor is set. 

Performs a two's complement of the B register (i.e., one's 
complement, incremented by 1). If a carry occurs, the Extend 
flag in the processor is set. If an overflow occurs (a carry from 
bits 14 or 15, but not both), the Overflow flag in the proces- 
sor is set. 

Binary multiply. Uses Booth's Algorithm. The values of the A 
and B registers are multiplied together with the product 
placed into A and B. The A register contains the least 
significant bits and the B register contains the most significant 
bits and the sign. (An anomaly in the processor results in an 
improper result whenever A or B equals — 32 768.) 
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Branch Group 

This group of instructions allows you to alter the execution sequence unconditionally. It in- 
cludes the "jumps" and "returns" from subroutines. 



Instruction 



Description 



{location} [. I] 
{location} [, I] 



{value} 



Unconditionally branches to the specified location. 

Jumps to a subroutine. The value of the R register is in- 
cremented and the current value of the P register (i.e., the 
location of the JSM instruction itself) is stored into the ad- 
dress pointed to by the R register. Execution then proceeds to 
the specified location. 

Returns from a subroutine, {value} is added to the contents of 
the address pointed to by the R register. The results are 
stored in the P register (i.e., specifying the next location for 
execution) and the R register is decremented. This is, in ef- 
fect, a return from a JSM instruction to the instruction which 
is {value} instructions from the JSM itself. The "usual" return 
is RET 1. {value} must be an integer between -32 and 31. 
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Test/ Branch Group 

Similar to the Branch group, this group of instructions allows you to alter the execution 
sequence, but conditionally upon the result of some test. Most instructions involve tests on all 
or part of one of the arithmetic accumulators (the A and B registers), but a couple allow a test 
on a location in memory which you can specify. 



Instruction 


Description 


CPFi {location} [, I] 


Compares the contents of the A register with the contents of 




the specified location. Execution skips over the next word if 




the contents are not equal. 


CP B {location} [, I] 


Compares the contents of the B register with the contents of 




the specified location. Execution skips over the next word if 




the contents are unequal. 


S2!F! {address} 


Skips to {address} if register A is 0. 


S2'H {address} 


Skips to {address} if register B is 0. 


RZFi {address} 


Skips to {address} if register A is not 0. 


R 2:; B {address} 


Skips to {address} if register B is not 0. 


S I Fi {address} 


Skips to {address} if register A is 0, then increments A regard- 




less. The Extend and Overflow flags in the processor are not 




affected by the incrementing action. 


SIB {address} 


Skips to {address} if register B is 0, then increments B regard- 




less. The Extend and Overflow flags in the processor are not 




affected by the incrementing action. 


R I Fi {address} 


Skips to {address} if register A is not 0, then increments A 




regardless. The Extend and Overflow flags in the processor 




are not affected by the incrementing action. 


R I B {address} 


Skips to {address} if register B is not 0, then increments B 




regardless. The Extend and Overflow flags in the processor 




are not affected by the incrementing action. 
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Test/ Alter/ Branch Group 

Similar to the Test/ Branch group, this group of instructions allows you to conditionally alter 
the execution sequence. In addition to tests, you can also alter the contents of the item being 
tested (such as set or clear a bit, or increment or decrement a register). Certain bits in the 
processor (Extend and Overflow) can be tested with some of these instructions, as well as 
registers and memory locations. 

Some instructions may be followed by either of the following — 



indicating that the bit being tested by the instruction will either be set (S) or cleared (C) after the 
test has been made. 



Instruction 



{location} [, I] 

{location} [, I] 

{address} [ , S] 
{address} [ = C] 

{address} [ , S] 
{address} [ , C] 

{address} [ , S] 
{address} [ , C] 

{address} [ , S] 
{address} [ , C] 

{address} [ , S] 
{address} [ , C] 



Description 



Increment the contents of the specified location and skip 
execution of the next word if the result is 0. 

Decrement the contents of the specified location and skip 
execution of the next word if the result is 0. 

Skips to {address} if the A register is positive or zero (bit 15 is 
0). 

Skips to {address} if the B register is positive or zero (bit 15 is 
0). 

Skips to {address} if the A register is negative (bit 15 is 1). 



Skips to {address} if the B register is negative (bit 15 is 1). 

Skips to {address} if the least significant bit of the A register is 
0. 
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Instruction 


Description 


SLB {address} [, S] 
SLB {address} [= C] 


Skips to {address} if the least significant bit of the B register is 
0. 


RLR {address} [, S] 
RLH {address} [. C] 


Skips to {address} if the least significant bit of the A register is 
notO. 


RLB {address} [, S] 
RLB {address} [, C] 


Skips to {address} if the least significant bit of the B register is 
notO. 


SOS {address} [, S] 
SC^S {address} [, C] 


Skips to {address} if the Overflow flag in the processor is set. 


SOC {address} [. S] 
SOC {address} [, C] 


Skips to {address} if the Overflow flag in the processor is 
cleared. 


SES {address} [, S] 
SES {address} [, C] 


Skips to {address} if the Extend flag in the processor is set. 


SEC {address} [, S] 
SEC {address} [, C] 


Skips to {address} if the Extend flag in the processor is 
cleared. 



NOTE 

The Extend and Overflow flags can be cleared only by using 
the SEC, SES, SOC, and SOS instructions with the , C op- 
tion. 
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Shift /Rotate Group 

This group of instructions performs re-arrangements of bits in the arithmetic accumulators (the 
A and B registers). Circular and non-circular shifts are available. 



Instruction 


Description 


SFiF? {value} 


Shifts the A register right the indicated number of bits with all 




vacated bit positions becoming 0. 


SBBF? {value} 


Shifts the B register right the indicated number of bits with all 




vacated bit positions becoming 0. 


SFiL. {value} 


Shifts the A register left the indicated number of bits with all 




vacated bit positions becoming 0. 


::BBL. {value} 


Shifts the B register left the indicated number of bits with all 




vacated bit positions becoming 0. 


iHFiR {value} 


Shifts the A register right the indicated number of bits with 




the sign bit filling all vacated bit positions. (Arithmetic right) 


FtBF:' {value} 


Shifts the B register right the indicated number of bits with 




the sign bit filling all vacated positions. (Arithmetic right) 


F::FiF? {value} 


Rotates the A register right the indicated number of bits. Bit 




rotates into bit 15 each time. (Right circular) 


F^BF: {value} 


Rotates the B register right the indicated number of bits. Bit 




rotates into bit 15 each time. (Right circular) 


Full, {value} 


Rotates the A register left the indicated number of bits. Bit 15 




rotates into bit each time. (Left circular) 


F^::BI {value} 


Rotates the B register left the indicated number of bits. Bit 15 




rotates into bit each time. (Left circular) 
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Logical Group 

This group of instructions performs logical (Boolean) operations upon the contents of an 
arithmetic accumulator (on A or B register). Logical "and" and "or" operations are available, 
along with complementing and clearing operations. 



Instruction 



Description 



{address} [. I] 



{address} [, I] 



Logical "and" operation. The contents of the A register are 
compared bit by bit, with the contents of the specified loca- 
tion. For each bit-comparison a 1 results if both bits are I's, a 
results otherwise. The 16-bit result is left in A. 

Logical "inclusive or" operation. The contents of the A regis- 
ter are compared, bit by bit, with the contents of the specified 
location. For each bit-comparison, a results if both bits are 
O's, a 1 otherwise. The 16-bit result is left in A. 

Performs a one's complementof the A register (i.e., bit-by-bit 
inversion of all 16 bits). 

Performs a one's complement of the B register (i.e., bit-by-bit 
inversion of all 16 bits). 

Clears register A. This instruction is identical to SAR 16. 

Clears register B. This instruction is identical to SBR 16. 
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Stack Group 

The Stack group of instructions provides you with operations for managing stacks. The instruc- 
tions withdraw items from (also called "pop" or "pull") or push items onto a stack pointed to 
by cither the C or D register. The items are pushed from or withdrawn into a specified register 
(other than C or D) and the C or D register is incremented or decremented appropriately. 

Pushing instructions increment or decrement the C or D register prior to doing the pushing. 
Withdrawing instructions increment or decrement the C or D register after doing the with- 
drawal. Consequently, the pointer is always left pointing to the "top" of the stack after the 
operation. 

Decrementing the C or D register is indicated by including , □ after the operand. For "with- 
drawing" instructions, D is the default. For example, the following are equivalent — 



iAJWi. 



Incrementing is specified by including , i after the operand. This is also the default for "push- 
ing" instructions if neither I or D is included. For example, the following are equivalent — 



When using the byte instructions (PBC, PBD, WBC, WBD), the address pointed to by the C or 
D register must not have an absolute address less than 408. 

When pushing or withdrawing bytes, the least significant bit of the address register (either C or 
D) is used to determine which byte is desired in the stack (a implies the left most byte of the 
word being addressed). To retain the full 16-bit addressing capability, the Cb or Db register is 
used, as appropriate. These one-bit registers hold the most significant bit of the word address 
when the byte addressing instructions are used. They should be explicitly set or cleared, 
depending upon the value of the address involved. 
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Instruction 


Description 




{register} , 


1 


Pushes contents of {register} onto the stack pointed to by the 




{register} [ , 


I] 


C register. 




{register} , 


J 


Pushes contents of {register} onto the stack pointed to by the 




{register} [ , 


I] 


D register. 




{register{ , 


J 


Pushes the lower byte (right half) of {register} onto the stack 




{register} [ , 


I] 


pointed to by the Cb and C registers. If the least significant bit 
of C is a 1, the byte is placed in the lower byte of the word in 
the stack; if it is a 0, it is pushed into the upper byte. 


F-B 


J {register} , 


J 


Pushes the lower byte (right half) of {register} onto the stack 




J {register} [ , 


I] 


pointed to by the Db and D registers. If the least significant bit 
of D is a 1, the byte is placed in the lower byte of the word in 
the stack; if it is a 0, it is pushed into the upper byte. 


WiAi 


{register} [ . 


□] 


Withdraws a word from the stack pointed to by the C register 


i---.i !•■■■■! 


{register} , 


[ 


and stores it into {register}. 


U-\ M 


{register} [ , 


D] 


Withdraws a word from the stack pointed to by the D register 


\A\A 


{register} , 




and stores it into {register}. 




{register} [ „ 


D] 


Withdraws a byte from the stack pointed to by the Cb and C 




{register} = 




registers and places it into the lower byte (right half) of {regis- 
ter}. If the least significant bit of C is a 1, the byte is withdrawn 
from the lower byte of the word in the stack; if it is a 0, it will 
be withdrawn from the upper byte. 


m .D 


{register} [ , 


□] 


Withdraws a byte from a stack pointed to by the Db and D 


1 l""i i 


{register} „ 




registers and places it into the lower byte (right half) of {regis- 
ter}. If the least significant bit of D is a 1, the byte is withdrawn 
from the lower byte of the word in the stack; if it is a 0, it is 
withdrawn from the upper byte. 

Clears the Cb register (indicates lower block of memory). 

Sets the Cb register (indicates upper block of memory). 

Clears the Db register (indicates lower block of memory). 


iJ hi i 


J 




Sets the Db register (indicates upper block of memory). 
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BCD Math Group 

This group of instructions provides you with BCD arithmetic operations using the Arl and Ar2 
registers. 

In general, the instructions associate the Arl register with "X" and the Ar2 register with "Y" in 
the mnemonic for the instruction. Both registers contain values which are considered BCD 
full-precision values when operated upon by instructions in this group. 

The mantissas referred to below consist of 12 BCD digits. All the shifting operations manipulate 
the digits as units (i.e., 1 digit — or 4 bits — at a time). In addition, shifting operations involve 
an additional digit in the A register (located in the lower 4 bits, numbered through 3). 

All arithmetic is performed in BCD. The values being operated upon are assumed to be nor- 
malized BCD floating-point (full -precision) values. Signs and exponents are left strictly alone. 
There is a flag in the processor, called Decimal Carry, which is set when an overflow occurs 
during a BCD operation. 

A full discussion of BCD arithmetic techniques can be found in Chapter 5. 



Instruction 



Description 



Mantissa right shift on Arl. The number of digits to be shifted 
is specified in the lower 4 bits (0-3) of the B register. The shift 
is accomplished in three stages — 

1. The digit in bits (0-3) of the A register is right-shifted into 
the first digit of the mantissa, with the twelfth digit being 
lost. This is the first shift. 

2. The mantissa digits are then right-shifted for the remaining 
number of digits specified. The twelfth digit, except for the 
last shift, is lost on each shift and the vacated digits are 
zero-filled. 

3. Finally, the last right-shift takes place with the twelfth digit 
shifting into the A register. The Decimal Carry flag in the 
processor is cleared along with the upper 12 bits of the A 
register (4-15). 



Instruction 
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Description 



Mantissa right-shift on Ar2. The number of digits to be shifted 
is specified in the lower four bits (0-3) of the B register. The 
shift is accomplished in three stages — 



1. The digit in bits (0-3) of the A register is right-shifted into 
the first digit of the mantissa, with the twelfth digit being 
lost. This is the first shift. 

2. The mantissa digits are then right-shifted for the remaining 
number of digits specified. The twelfth digit, except for the 
last shift, is lost on each shift, and the vacated digits are 
zero-filled. 

3. Finally, the last right-shift takes place, with the twelfth digit 
shifting into the A register. The Decimal Carry flag in the 
processor is cleared along with the upper 12 bits of the A 
register (4-15). 

Mantissa left-shift on Ar2 for one digit. This is a circular shift, 
with the digit in bits (0-3) of the A register forming a thir- 
teenth digit. The non-digit part of the A register is cleared 
(i.e., bits 4-15), and the Decimal Carry flag in the processor is 
cleared. 

Mantissa right-shift on Arl for one digit. The twelfth digit is 
shifted into the A register (bits 0-3). The non-digit part of the 
A register is cleared (i.e., bits 4-15), and the Decimal Carry 
flag in the processor is cleared. The first digit in the mantissa 
is set to 0. 

Normalizes the Ar2 mantissa. The mantissa digits are left- 
shifted until the first digit of the mantissa is non-zero, or until 
twelve shifts have taken place, whichever comes first. If the 
original first digit is already non-zero, no shifts occur. The 
number of shifts required is stored as the first four bits (0-3) of 
the B register. If twelve shifts were required, the Decimal 
Carry flag in the processor is set, otherwise it is cleared. 

Ten's complement of Arl. The mantissa of Arl is replaced 
with its ten's complement and Decimal Carry is cleared. 
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Instruction 



Description 



{address} 



{address} 



Ten's complement of Ar2. The mantissa of Ar2 is replaced 
with its ten's complement and Decimal Carry is cleared. 

Fixed-point addition. The mantissas of Arl and Ar2 are 
added together, and the result is placed into Ar2. Decimal 
Carry is added to the twelfth digit. After the addition, Decimal 
Carry is set if an overflow occurred, otherwise Decimal Carry 
is cleared. 

Mantissa word addition. The contents of the B register are 
added to the ninth through twelfth digits of the mantissa of 
Ar2. Decimal Carry is added to the twelfth digit; if an over- 
flow occurs. Decimal Carry is set, otherwise it is cleared. 

Fast Multiply. Performs the multiplication by repeated addi- 
tions. The mantissa of Arl is added to the mantissa of Ar2 a 
specified number of times. The number of times is specified in 
the lower 4 bits (0-3) of the B register. The result accumulates 
in Ar2. If intermediate overflows occur, the number of times 
they occur appears in the lower 4 bits of the A register after 
the operation is complete. The upper 12 bits of the A register 
are cleared along with Decimal Carry. 

Fast divide. The mantissas of Arl and Ar2 are added together 
until the first decimal overflow occurs. The result accumulates 
into Ar2. The number of additions without overflow is placed 
into the lower 4 digits of the B register (0-3). The remainder 
of the B register is cleared, as is the Decimal Carry flag in the 
processor. 

Clears the Decimal Carry flag in the processor. 

Skips to {address} if Decimal Carry is set. Decimal Carry is a 
flag in the processor which may be set as the result of certain 
BCD arithmetic operations (see Chapter 5 for details). 

Skip to {address} if Decimal Carry is cleared. Decimal Carry is 
a flag in the processor which may be set as the result of 
certain BCD arithmetic operations (see Chapter 5 for details). 
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I/O Group 

The I/O group of instructions provides you with some of the operations necessary to accessing 
peripheral devices through the I/O bus. In addition to the instructions contained here, there 
are instructions in other groups which can have I/O effects (e.g., LDA, STA...). 

The techniques useful to the implementation of I/O operations using the instructions in this 
group and the other groups are discussed in Chapter 7. 



Instruction 


Description 


SFS {address} 


Skips to {address} if the Flag line is set (true). The Flag line is 




associated with a peripheral on the current select code (see 




Chapter 7 for details). 


'dF C {address} 


Skips to {address} if the Flag line is clear (false). The Flag line 




is associated with a peripheral on the current select code (see 




Chapter 7 for details). 


EBS-Ei {address} 


Skips to {address} if the Status line is set (true). The Status 




line is associated with a peripheral on the current select code 




(see Chapter 7 for details). 


SSC {address} 


Skips to {address} if the Status line is clear (false). The Status 




flag is associated with a peripheral on the current select code 




(see Chapter 7 for details). 


EIF? 


Enables the interrupt system. Cancels the DIR instruction. 


DIF? 


Disables the interrupt system. Cancels the EIR instruction. 


:::::::jjO 


Sets DMA outwards. Directs that DMA operations read from 




memory, write to the peripheral. 


SDI 


Sets DMA inwards. Directs that DMA operations read from 




the peripheral, write to memory. 


Jjilf"! 


Enables the DMA mode. Cancels the DDR instruction. 


DDF? 


Disables Data Request. Cancels the DMA instruction. 
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Miscellaneous 

The following instructions are unclassifiable into any of the other groups. 



Instruction 



Description 



{value} [, I] 



Null operation. This is exactly equivalent to LDA A. 

The contents of any register can be treated as the current 
instruction and executed, {value} is a numeric expression in 
the range through 31, indicating the register to be used. 
The register is left unchanged, unless the instruction code 
causes it to be altered. The next instruction to be executed is 
the one in the word following the EXE, unless the code in the 
executed register causes a branch. 
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Chapter ^ 

Assembly Language 
Fundamentals 



Summary: This chapter discusses some of the basic statements and syntaxes used 
throughout the assembly language system. Program entry, assembling, symbolic opera- 
tions, module creation, program and variable storage, and utilities are the topics co- 
vered. 



When writing assembly language programs there are a number of things with which you will be 
involved constantly. In the beginning, questions arise on how to use the language: How do you 
enter the source code? What kind of symbolic addressing is there? How do you create and 
distinguish modules? How do you create the object code and where is it stored? What utilities 
are available and how do you use them? 

The answers to those questions form the underlying capabilities through which you write your 
applications. These arc things which nearly every assembly language program uses. As essen- 
tial as they are, however, none are difficult to master. 



Program Entry 



You were introduced early in Chapter 2 to the integrated nature of the assembly language with 
its host language, BASIC. You know from that chapter how assembly language statements can 
be intermingled with BASIC statements — that you can employ the usual editing features on 
the assembly statements. However, there is more to the ISOURCE statement than just its 
integrated nature with BASIC. 

As stated in Chapter 2, all assembly language statements are designated with the keyword 
"ISOURCE". The keyword is followed by {assembly language source}. So the syntax of the 
entry line is — 

{line number} [ {BASIC label} ;: ] ]E:iOLJI?C[I {assembly language source} 
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Here's a simple example of this from Chapter 2 — 



The {line number} and {BASIC label} are the same as you are used to in BASIC. However, it 
should be noted that the statement is not an executable one, so the BASIC label is only useful 
for documentation and EDIT purposes. 

To BASIC, the ISOURCE statement appears as a comment. If you were to change the above so 
that it read — 



and then executed a statement "GOTO Example", the result would be to simply execute the 
END statement in line 70. That is because, to BASIC, the lines appear the same as — 



or — 



The BASIC label on an ISOURCE line finds its most useful characteristic in being able to be 
referenced, as any other BASIC label on any other type of line may be, with an EDIT com- 
mand. Thus, if you were to execute — 



on the above, you would be working in the editor, starting with line 40. This feature will 
become useful during program development as will be pointed out shortly. 
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Assembly Language Source 

You may have recognized the assembly language instruction and pseudo-instiructions to the 
right of ISOURCE in the examples above. This is where your instructions and pseudo- 
instructions appear. However, the source is a little more versatile than that. In general, {assem- 
bly language source} has the syntax — 

[ {label} ;; ] {action} [ ! {comment} ] 

Or, the action may be omitted and only a comment appears — 

[ {label} : ] ! {comment} 

A label is always optional in the source, but either an {action} or a {comment} must be present 
in every source line. 

Actions 

An {action} in assembly language source is — 

• A machine instruction, with any operand it may require. These were discussed at some 
length in Chapter 3. 

• A pseudo-instruction, with any operand it may require. These are discussed under the 
topics to which they relate. 

The actions contained in the above example were — 



Labels 

The {label} in assembly language source is part of the symbolic addressing capability of the 
assembler. This {label} is used by the assembler only. Neither the operating system nor BASIC 
is aware of its existence. 
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The label follows the same form and rules as do labels in BASIC — 

• Up to 15 characters long. 

• First character must be a capital letter (f i-Z). 

• Only the non-capital letters (a-z), the numerals (iZi to 9), or the underscore (...) may be 
used following the first character. 

No two labels are allowed to be the same in a given module. If your source consists of two or 
more modules, then the same label may be defined more than once, provided each definition is 
in a different module. (Distinguishing between modules is discussed in "Creating Modules", 
later in this chapter.) So you may not code — 



in one place in the module and later in the same module code — 



There are other restrictions as well on the choosing of labels. For instance, there are symbols 
already defined by the assembler and you are not allowed to choose one of them as a label. 
This is discussed at length in "Symbolic Operations" in this chapter. 

Both a BASIC label AND an assembly language source label can appear in the same line, and 
they are distinct from one another. BASIC does not know about the source label and the 
assembly language system does not know about the BASIC label. 

Since neither BASIC nor the operating system is aware of the existence of source labels, actions 
ouside the assembler cannot reference these labels. Thus, if you had the source line — 



You can neither say GOTO Rumpelstiltskin nor EDIT Rumpelstiltskin. Neither of these can find 
"Rumpelstiltskin", since only the assembler can know it is there. 
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This can be a nuisance in some instances during program development. Many programmers 
use labels almost exclusively and rarely consider the line number when using the editor to 
change a line. For instance, in the above, they would not be used to saying, "EDIT 100" to get 
at the line in order to change it. They are more used to saying, "EDIT Rumpelstiltskin". A way 
for them to do it would be to change the line to — 



Note that, as the example demonstrates, the name can be the same in the BASIC label as in the 
source. This takes advantage of the fact that BASIC and the assembler are unaware of each 
other's labels. The names do not have to be the same. 

Comments 

As with any BASIC line, a comment may be included by simply adding an exclamation point 
( ! ) and typing your comment after it. Since you have a total of 160 characters for a line, your 
comment may fill up the remainder of the 160 characters left after the rest of the statement has 
been provided (line number, ISOURCE keyword, label, action). 

Syntax! ng the Source 

When you are creating your source program, you are either entering' it from the keyboard or 
retrieving it from mass storage (LINK or GET). In either case, as the statement is entered (the 
(^^ key on the keyboard is pressed or a record is read from mass storage), the operating 
system takes note of any use of the keyword ISOURCE. When a line has this keyword, the 
operating system turns over the remainder of the line following the keyword to the assembly 
system. The assembly system, then and there, checks the syntax of the source. 

By checking the syntax at the time of entry of the statement, a considerable amount of proces- 
sing time is saved when the time comes to assemble the source into object code. In addition, it 
gives you, as the programmer, immediate feedback when a syntactical error occurs. You do not 
have to wait until assembly time just to find out that you misspelled NOP. 
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At syntax time, the assembler takes care of capitalization, lower case, and spacing for the 
source. It's quite similar to the SPACE DEPENDENT mode of entry for BASIC statements (that 
mode is not required to get the effect with the assembly system). It follows the following rules in 
syntaxing the source — 

• Everything between the ISOURCE and the colon (if present) is the label. Its initial 
character is capitalized and the remaining letters are converted to lower-case. This is 
regardless of whether they were entered in that form. 

• The label, if present, is left-justified to the second column following the keyword 
ISOURCE. 

• The first three letters following the colon (or just the first three letters, if there is no label) 
are considered the machine instruction or pseudo-instruction and are capitalized. The 
instruction will remain in the same column as it was entered, and, if possible, a space is 
added after it. 

• Everything after the instruction or pseudo-instruction is considered the operand for the 
instruction, up until the exclamation point before the comment (if any). Any label (sym- 
bol) in the operand will have its initial character capitalized and the remaining letters 
converted to lower case automatically. 

• Comments are unchanged and remain in the same columns as entered, whenever possi- 
ble. 

In short, simply enter the statement in your most comfortable fashion and the assembly system 
automatically assures that what you enter is in the proper form (though it still can't guarantee 
that you have entered the right instruction for what you mean to do. 

As a demonstration of this facility, consider the following line ready for syntaxing — 



It becomes — 
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Creating Modules 



When you were introduced in Chapter 2 to the concept of a module, it was said that a module is 
given a name through the NAM pseudo-instruction. 

So, when you enter a source line which has the following form — 

NFii 1 {module name} 

you are assigning a name to a module, and you are also delimiting the beginning of the module. 
By the inclusion of this statement, all source lines which follow are part of the module with the 
name designated in this source line, that is, all lines until the END pseudo-instruction is encoun- 
tered in the source. It has the form — 

END {module name} 

Its {module} name must be the same as in the NAM pseudo-instruction. 

A {module name} follows the same rules for naming as do labels (see above). 

It is by the use of these two instructions that modules are created. The source lines which 
appear between them comprise a single module, and the name assigned to the module is the 
one with which the module is referenced (with the ILOAD and ISTORE statement for example). 

When it comes time to assemble the source into object code, the assembler treats the source 
lines in a module as a unit. 

In actuality, therefore, there are two modules — a source module and an object module. When 
you are assembling a module, the name you use refers to the source module and creates the 
object module. Later, other statements, such as ISTORE and ILOAD, refer solely to the object 
module. 
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Storage 

Modules 

When assembly converts a source module into an object module, there must be a place to keep 
the object module. That is the function of the ICOM region. 

You were introduced to the ICOM region in Chapter 2 in connection with the loading and 
storing of modules. It is also used to hold modules which are created through assembly. Once a 
module has been assembled, the object code appears in the ICOM region just as if you had 
loaded it from mass storage. 

Variables 

Within a module, you may want to set aside one or more words of memory for your use. For 
example, you might need a location to store a variable, or keep a counter, or save a register. 
This is done with the BSS pseudo-instruction — 

BSS {number} 

where {number} is the number of words to be set aside, {number} can be any absolute expres- 
sion, provided the expression evaluates to a positive integer (see "Symbolic Operations" 
below). 

This kind of storage is part of the object code and is set aside "in-line". This means that 
wherever it appears in the source, the storage appears in the same relative location in the object 
module. 

For example, suppose a rriodule contained the following source lines — 
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Then, at some appropriate spot in the object module (relative to the other instructions in the 
module) there would be the following contiguous locations — 

Save_a 1 word 

Save_4 4 words 

Renras some number of words equal to "the absolute symbol, Larry"^ 

Again 1 word 

The locations at labels Save_a, Save_4, and Renras are merely reserved by the BSS pseudo- 
instructions, and their contents are not initialized to any particular value. 

It is possible to accidentally execute these locations when the routine is run if you're not 
careful. Ordinarily, you should place these locations somewhere safely out of the potential 
execution sequence, since they are used just for storage. Some applications, though, use 
self-generating code, and a BSS is a way to set aside locations for it. 

Data Generators 

A "data generator" is very much like a BSS operation. The function, as with the BSS, is to set 
aside words of memory at a particular location in the object code. But in addition, the words are 
to be initialized to some value. The initialization occurs at the same time the words are set aside 
(i.e., at assemble-time). 

This is done using the DAT pseudo-instruction which has the form — 

DFiT {expression} [, {expression} [ , ...]] 

An {expression} may be any absolute or relocatable expression. The various forms that an 
expression may take are discussed in "Symbolic Operations" later in this chapter. 

As an example, suppose you want the value 100 (a decimal integer) to be located at location 
"X" in the object module. You can achieve this by identifying the location in the source code 
(ultimately the object code) where you want the value to be, then placing this instruction at that 
point — 



1 Such symbols are discussed at length in the "Symbolic Operations" section later in this chapter. 
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Upon encountering this pseudo-instruction, the assembler generates the words necessary to 
store the value (in this case, only 1 word is necessary). It then stores the value (100) into the 
word{s) and proceeds with the remaining assembly. Thus, the location of the words is depen- 
dent upon the instruction's relative position in the source module, the same as with any 
machine instruction. 

The number of data words generated for each {expression} is dependent upon the result of the 
{expression} — 



Result 


Words 


Full-precision 


4 


Short-precision 


2 


Decimal integer 


1 


Octal integer 


1 


Address^ 


1 


Literal 


1 


String 


actual length (2 characters per word) 



If more than one {expression} is present, the necessary data words are generated in the order in 
which they appear in the list. As an example, if you were to include the instruction — 



ten words would be set aside and initialized to the appropriate values — 



-"2" 
-'2 

— address of 2 in literal pool 



1 including "external" 
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Repeating Instructions 



To help relieve the tedium of writing the same instruction many times (which many applications 
occasionally require), a "repeat" pseudo-instruction is provided — 

F?E~P {expression} 

The pseudo-instruction causes the immediately following machine instruction to be duplicated 
in the object code {expression} number of times. 

For example, suppose you are writing a real-time application where timing was critical, and to 
make things work correctly you need 10 NOPs at a certain location. Ordinarily you would 
type — 



ISO 



But all of this could be replaced with 



and the same effect would be achieved. 

Some pseudo-instructions may not be replicated. They are — 
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Assembling 



Object code is created by "assembling" the source code. Again, modules are a key factor. The 
assembly directive is aimed at modules, using the module name as a delimiter in the source 
code so the assembler can tell which ISOURCE statements to assemble as part of the module. 
Of course this same name is also used to store the object code using mass storage. 

The lASSEMBLE statement is the vehicle for assembling modules. It has the forms — 

; .- {module} [ , {module} [ , ...]][;; {option} [ , {option} [ , ...]]] 
■.■..[ ._][;; {option} [ , {option} [ , ...]]] 

Each {module} indicated is assembled, in the order given by the statement. Only those modules 
are assembled; any others which may be present in the source at the time are ignored. If the 
ALL version of the statement is used (with or without the optional word ALL), every module 
present in the source is assembled. 

An {option} falls into one of two categories: listing directives and conditions (for conditional 
assembly). These are discussed separately below. The options, and their categories, are — 



Listing directives 



' Conditions 



Effect of BASIC Environments 

To assemble a module, all of its source lines (between the NAM and END pseudo-instructions) 
must lie within the same BASIC "environment". That is, the NAM and END for a module must 
lie within the main program or within the same subprogram or multi-line function. For modules 
where this is not true, an error ("EN" assemble-time error) occurs. 
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Source Listing Control 

Listings of the source code in a module can be obtained during an assembly. These listings 
contain the line numbers, instructions, and comments from the source lines along with the 
associated machine addresses and contents of that address. 

Here is part of a typical listing — 






: nf 






line absolute^contents^ actions ^-comments 

numbers addresses 

The addresses and contents are displayed in octal representation. 

Listings are not automatic. They are obtained in one of two ways — 

• By using the LIST option in the lASSEMBLE statement. This directs that a listing is 
desired for all the modules in the statement. The statement would look like the following 
examples — 



• By using the LST pseudo-instruction in the source code itself. 

Modules can be just partially listed, if desired. This kind of control is achieved by using the LST 
and UNL pseudo-instructions within the source code, placing the LST before any instructions 
which you want listed, and placing the UNL before any instructions you do not want listed. For 
example, if the following source lines are assembled — 






only lines 430 through 500 would be listed. 
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The primary purpose of this capability is to allow as much modularity in the listings as you can 
get in source code. To implement this purpose, a "listing counter" is used. 

Whenever an LST instruction is encountered during an assembly, the listing counter is in- 
cremented. Whenever an UNL instruction is encountered during an assembly, the listing 
counter is decremented. Source lines arc listed whenever the counter is greater than 0. 
Whenever it is equal to or negative, then no lines are listed. 

The counter is set to upon execution of the lASSEMBLE statement. This is why there is no 
automatic listing. However, if the LIST option is included in the lASSEMBLE statement, then 
the counter is initialized to 1. This is why that option creates a listing. Thus, you could defeat a 
LIST option by placing an UNL instruction at the beginning of a module. This initialization 
occurs for each module assembled, so if you have more than one module indicated in your 
lASSEMBLE statement, the counter is set at the beginning of the assembly for each. 

This capability sees its greatest usefulness during debugging stages and while working with 
independently written sections of source code. For example, a number of people could be 
writing different sections of code, each containing their own LST and UNL instructions. These 
instructions could then be overridden when they were combined into a single module by 
preceding the sections with an LST instruction (to get a listing) or an UNL (to suppress the 
listings). 

Page Format 

Each and every assembly listing page has the following format — 

• The word "PAGE" and the current page number of the listing occurs on the first line 
starting at column 49. 

• A heading occurs on the second line, left- justified. The heading always includes — 

MODULE: {name} 

where {name} is the name of the module currently being assembled. Additional heading 
information can be specified for this line (see "Page Heading" below). 
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• A blank line follows the heading. 

• The text follows the blank line. The number of lines printed depends upon the LINES 
option in the lASSEMBLE statement, the number of source lines encountered, and the 
SKP pseudo-instructions which may be encountered while assembling the source. LINES 
and SKP are described in the following sections. 

• If the EJECT option is not included in the lASSEMBLE statement, then a minimum of 
three blank lines (carriage return /line feed, CR/LF, pairs) will be printed at the end of a 
page. The number may exceed three if the number of source lines printed on a page is less 
than the standard length for a listing page (see above). 

Page Length 

The length of the text in each page of your assembly listings can be specified through the 
lASSEMBLE statement using the LINES option, which has the form — 

L INES {numeric expression} 

This option directs that any listing of the routines being assembled have pages of the length 
indicated by {numeric expression}, which must be a positive value. This value becomes the 
"standard length" of the listing pages, specifying the number of source lines to be printed on a 
page during listings of the assembly source. It is not necessary that this value be the page length 
of the printing device being used, though this is frequently the value selected. 

If the option is omitted from the lASSEMBLE statement, the value of 60 is assumed for page 
length, giving an overall page size of 66 lines. 

Printer control characters, such as line-feed and form-feed, in a comment can affect the actual 
printing length of the pages independent of the length you specify. Thus, a page length of 60 
could result in actually 61 lines if one of the comments in your ISOURCE statements contains a 
line-feed character. 

End-of-Page Control 

At any time during the assembly of a module, you can force the listing to continue printing at 
the top of the next physical page by including — 

SKP 

at the desired spot in the module. If a listing is being generated when this pseudo-instruction is 
encountered in the source code, the printer is sent to top-of-form. This is physically done in one 
of two ways — 
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• If the EJECT option was included in the lASSEMBLE statement which is assembling the 
module, then a form-feed character (ASCII character 148), is sent to the printer. 

• If the EJECT option was not included, sufficient CR/LF pairs (ASCII characters ISs and 
128) are sent to the printer to fill out the standard length of a listing page (plus three at the 
end of the page). Thus, if you already have printed 10 lines on a page, and an SKP 
instruction was encountered, the assembler sends (length — 10 + 3) CR/LF pairs. 

The SKP instruction is not required to cause pagination to occur when the standard length of a 
listing page is exceeded. Thus, if you are working with a default length of 60 for your standard 
length, then each 60 lines from the last page break forces a new page break. 

Page Headings 

The heading for each listing page is — 

riODULil: {name} 

where {name} is the name of the module currently being assembled. This heading can have 
additional information added to it through the HED pseudo-instruction. This instruction has the 
form — 

{comment} 



When this instruction is encountered, and a listing is being generated, pagination immediately 
occurs, the same as with the SKP instruction (see above). On the new page, and on all pages 
after it, the indicated {comment} appears after {name} in the heading, replacing any previous 
information specified by an earlier HED instruction. 

You can change the heading any number of times in a listing. This is frequently done in order to 
generate documentation by sections, even though all sections may reside in a single module. 

The heading appears on the page exactly the same as in {comment}, including the positioning 
of blanks, control characters, etc. 
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Blank Line Generation 

If occasional blank lines are desired in a listing (usually to set off sections of code, or com- 
ments), they may be generated by including — 

SF'C {number} 

at the desired spot in the source statements, {number} designates the number of blank lines 
desired, {number} can be any absolute expression, provided the expression evaluates to a 
positive integer (see "Symbolic Operations" below). 

Non-Listable Pseudo-Instructions 

The following pseudo-instructions do not appear in a listing — 



Conditional Assembly 

For reasons of complexity or length, it is occasionally desirable to selectively assemble only 
parts of a module. This is particularly true during the debugging stage of longer, complex 
assembly programs. "Conditional assembly" is the ability to designate certain portions of a 
module for assembly, depending upon conditions established by the lASSEMBLE statement. 

You may recall from the description of the lASSEMBLE statement earlier, there are options 
called "conditions" available with the statement. These conditions — 
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are used to designate which conditions are "set" during the assembly. By including one or 
more of these conditions, all conditional assembly statements predicated upon that condition 
are assembled. For example, if the following statement is executed — 



then any occurrence of conditional assemblies based on "A" are assembled. Also, any condi- 
tional assemblies based on B through H are not assembled, since those conditions were not 
included in the options for the lASSEMBLE statement. 

The conditional assembly sections are delimited by pseudo-instructions. A conditional section 
begins with one of the following — 



T F" H 
TFB 
IPC 
x r ij 
IFE 
IFG 
IFH 



and it concludes with — 

KIF 

In addition to the lettered conditions, a numeric condition can be tested by using an IFP 
pseudo-instruction. It has the form — 

IFF' {absolute expression} 

The condition is considered true if {absolute expression} evaluates as a positive value. It should 
be noted that this is an assembly-time construct, meaning that the variables contained in the 
expression are evaluated at the time of assembly. 

The IFP instruction performs in the same manner as the IFA through IFH instructions. It also 
terminates with the XIF instruction. 



Assembly Language Fundamentals 67 



The conditional assembly is based upon a flag. At the beginning of the assembly for a module 
the flag is set so that object code is generated for all instructions. An IF conditional encountered 
during the assembly which does not have its condition set turns off the flag so that no further 
code is generated. Encountering an XIF statement resets the flag so that code generation can 
resume. For instance, if the source is — 



Then if 



is executed, lines 430 through 460, 480, and 490 are assembled, but 520 through 550 are not. 
Line 570 is assembled. 

The one XIF actually affected both conditions. This effect is more dramatically illustrated by — 



where neither A nor B is set. In this qase 480, 490, 520 through 550 are not assembled. But 550 
is assembled! 

The effect of the XIF, then, is as a flag for all the conditions. As a consequence, it is not possible 
to "nest" conditional assemblies. This effect is the same with the IFP conditional. 
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Relocation 

The code talked about in this section is relocatable. You do not have to worry about the 
absolute location of your module. The assembler automatically generates the appropriate 
machine codes for each of your instructions to assure that the correct location is reached when 
referenced. 

Some instructions generate relocatable object code in which the operand address is an offset 
from the current address and the relocating loader has to make no changes to the object code 
for them as long as they are within - 512 and + 511 of the current address. 

For indirect addressing, and for instructions which are more than 512 words away from the 
current address, it is required of the loader to adjust the address in the intermediate word to 
reflect the actual address being referenced. For indirect addressing generated by the assembler, 
this activity is automatic. 

Some instructions permit you to specify an absolute machine address for its operand. In those 
cases, the assembler generates the code necessary to perform the reference to the absolute 
location. 

For example, if the instruction was assembled — 



(which essentially says "load register A with the contents of register B) the result would be a 
machine instruction which references the B register (absolute address 1). This reference would 
be independent of the actual location of the instruction itself. 

There are a couple of ways to produce an absolute address in an operand. The pre-defined 
symbols are one way. There is a type of expression known as "absolute" which is another way. 
Both of these are dicussed in the next section, "Symbolic Operations". 

You should never try to use absolute addressing within the ICOM region, since not only is the 
location of the region itself not fixed, but modules can be moved around within the region. 
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Symbolic Operations 



You have been introduced, in small doses, to symbols throughout the chapters preceding this 
one. The idea of symbols in an assembly language is the same as it is in a higher language such 
as BASIC — to make operations simpler and the code more understandable. 

Several symbolic tools are provided for you in this assembly language system. You have' 
already seen one described in detail in this chapter — labels. There are some pre-defined 
symbols the assembly system provides for certain locations in the machine (mostly registers). 
There are ways to define your own symbols (and give them a "type"). And, there are ways to 
access symbols in other modules. 

Symbols can be used as operands in machine instructions and in some pseudo-instructions. 
They can be part of expressions in an operand. 

Pre-Defined Symbols 

The assembler has pre-defined a number of symbols and has reserved them as references to 
special locations in memory. Each of the locations has a special meaning and function. The 
symbols themselves are "reserved", meaning they cannot be re-defined (by using them as 
labels on something else). The symbols are — 



Symbol 




Description 


A 




Arithmetic accumulator 


Arl 
Ar2 




BCD arithmetic accumlators 


B 




Arithmetic accumulator 


Base page 


Global temporary area (50 words) 


C 




Stack pointer 


Cb 




Address-extension bit for byte pointer in C 


D 




Stack pointer 


Db 




Address-extension bit for byte pointer in D 


Dmac 




DMA count register 


Dmama 




DMA memory address register 


Dmapa 




DMA peripheral address register 


End_isr 


high 


■ 


End isr 


low 




Isr_flag 




■ Reserved symbols for writing interrupt service routines 


Isr psw 




f 
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Symbol 


Description 


Operl 
Opcr_2 


■ Arithmetic utility operand address registers 


P 


Program counter 


Pa 


Peripheral address register 


R 


Return stack pointer 


R4 




R5 
R6 


I/O registers 


R7 




Result 


Arithmetic utility result address register 


Se 


Shift-extend register 


Utl count 




Utlend 


Reserved symbols for writing utilities 


Utl temps 


. 



The meaning of each of these locations is discussed in other chapters. The absolute locations of 
the registers can be found in Chapter 2. A description of the function of the accumulators and 
pointers can be found in Chapter 3 as part of the discussion on machine instructions. A 
discussion of the I/O registers and symbols can be found in Chapter 7. The arithmetic registers 
are discussed in Chapter 5. 

Using a pre-defined symbol in a machine instruction is the same as using its address. For 
example — 



means simply that register A will be loaded with the contents of register B. The same effect 
could have been achieved with — 



except that the symbolic form makes it more obvious what is intended by the operation. This is 
true with most symbols. 
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Defining Your Own 

You are defining your own symbol each time you specify a label on an instruction or pseudo- 
instruction. Normally the "value" of the label is the address associated with the instruction. 
However, in two cases it is possible to create the label and specify what its value is to be. One 
case is when the label is on the EQU pseudo-instruction; the other case is when the label is on 
the SET pseudo-instruction. 

The EQU is an assembly-time construct. It exists only at the time of assembly to give you 
value-assigning capability to symbols. It generates no code itself, and it has no implementation 
or "location" in the object module. 

To define a symbol using an EQU, the form is — 
{label} : E] Q LJ {expression} 

the resulting symbol ( {label} ) has the same "type" as the expression (see "Expressions" 
below) and it has the same value as the result of the expression. 

As an example, assembling the statement — 

means that in all references in the module to the symbol "Three", it is the same as referring to 
the value 3. Thus — 



means load A with the contents of location 3. 

A common use for this instruction is to assign a symbol an address which is an offset from 
another address. For example, if this sequence were in a module — 



then Save_b would refer to the second word in the BSS area "Save_registers", and it would 
probably be used to store away the contents of the B register sometime — 



and later retrieve the value — 
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The SET pseudo-instruction defines a symbol in identical fashion to an EQU. Consequently, it 
has the same general form — 

{label} : S E T {expriession} 

The difference between the two is that the SET instruction can have its {label} be a symbol 
which has been previously defined. The effect in that case is to allow a redefinition of the 
symbol. For example, after assembling the following instructions — 



the symbol "Three" has the value SOB. 

Literals 

Literals are a special means of defining your own symbols without actually having to go to the 
trouble to do so. The result is a form of symbolic addressing without the symbol. 

The form of a literal is — 

= {expression} [, {expression} [, ...] ] 

where {expression} may be any absolute or relocatable expression (see "Expressions" below). 

Evaluation of Literals 

When a literal is encountered in an operand, three things occur — 

1. The literal is converted to its binary value. If there is more than one expression in the 
literal, then they are all converted. 

2. The binary value is stored in a literal pool. If there is more than one expression in the 
literal, then they are stored contiguously in the order specified. 

3. The address of where the value is stored is then substituted for the literal in the operand. 

If the same literal is used in more than one instruction, only one value is generated in the literal 
pool. All instructions using this literal refer to the same location. 
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Literals can be part of expressions as well as having expressions as part of them. Since they 
ultimately are replaced by an address (pointing to a specific location within a literal pool), their 
"type" is "relocatable". See the section on "Expressions" later in this Chapter. 

Basically, a literal means "the address of {expression}". An example should help in the under- 
standing of literals. Suppose that you want to store the value 1 into the A register. There are 
two ways you could accomplish that purpose. You could code — 



or, you could use a literal and code — 



Using the literal method is easier and is more self-documenting. While the literal form strictly 
says "load A with the contents of the address of the constant 1", it can also be read as "load A 
with the constant 1", and this short-hand version can be an excellent way of self -documenting 
your programs, not to mention the elimination of a lot of unnecessary symbols. 

Nesting Literals 

Since literals use expressions, and literals may be used in expressions, it is possible to have a 
literal within a literal (nesting). In fact, it may be done to any depth, though the most useful 
form of nesting is a single level. 

Suppose you want to initialize a variable to the value of pi each time you enter a routine. A 
nested literal would be a way of accomplishing this in a clean, straight-forward fashion — 
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and the locations starting at "Pi" now contains the full-precision value indicated (which is a fair 
approximation to pi). This would replace coding which could have looked like this (without 
using literals) — 



Nonsensical Uses of Literals 

A literal, basically, is an address. Since it can be used in an operand wherever an address may 
be used, it is possible to use it in instructions where the result is a little nonsensical. 

For example, consider the result of doing some of the following — 



Caution dictates that you well consider the appropriateness of the action when using the literal. 
Literals can be a highly useful tool, but only when properly employed. 

Literal Pools 

Literals are assemble-time constructs, but they eventually resolve to an actual address in the 
object code. That address points into a literal "pool". 

A literal pool is part of your module where the actual values of literals are stored. There is 
automatically a literal pool assigned at the end of each module where literals are used. As many 
literal values as possible are stored there by the assembler. However, in some cases, a literal 
pool is needed earlier in the program (a need indicated by the assembler with the "LT" 
assembly-time error). In that case a pool should be created using the LIT pseudo-instruction. 
This instruction has the form — 

LIT {size} 
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where {size} is the number of words to be set aside (it may be a positive numeric expression). 
The instruction acts very much like a BSS. And, like a BSS, it should be placed at a location in 
your code where it is not likely to be inadvertently executed. 

Most modules do not need assignment of an extra literal pool. However, one is needed where 
there is a literal used beyond 512 words from the first available space in the literal pool at the 
end of the module. To alleviate the problem, a literal pool must be created with the LIT 
statement within 512 words of the instruction. 

A common cause of this kind of problem is a large BSS assignment between the instruction and 
the end of the module. Sometimes moving the BSS to some other location is a solution to the 
problem. 

Expressions 

Literals, some pseudo-instructions (particularly EQU), and a number of machine instructions, 
all permit "expressions" to be used as an operand. These expressions take one of two 
forms — "absolute" or "relocatable". The type of an expression depends upon the type of the 
individual elements in it. 

An element is of the type "absolute" if it is any of the following — 

• A decimal integer (like 0, 1, 2, 1 024). 

• An octal integer (like lOB, 40B, lOOOOOB). 

• A string (enclosed by quote marks) (like "ERROR") 

• An ASCII character, preceded by an apostrophe (like 'A). 

• A label associated with an EQU or SET pseudo-instruction whose expression is also 
evaluative as type absolute (like EQU 40B), 

An element is of the type "relocatable" if it is any of the following — 

• A label not associated with an EQU or SET pseudo-instruction (i.e., it is an "address"). 

• A literal (like =0). 

• An asterisk, symbolizing "current address". 

• A label associated with an EQU or SET pseudo-instruction whose expression is also 
evciluative as type relocatable (like EQU *). 
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An expression is a list of elements each pair of which is separated by one of the following 
operators — 



meaning addition, subtraction, division, and multiplication, respectively, as in BASIC. 

The result of an expression is either absolute or relocatable depending upon the following 
rules: 

An absolute expression is any expression which contains ^ 

• Only absolute elements. 

• An even number of relocatable elements, paired in sequence and by sign (i.e., for each 
relocatable element there is another relocatable element adjacent to it, of opposite sign). 
These pairs may be in combination with absolute elements. 

A relocatable expression is any expression which contains — 

• An odd number of relocatable elements, paired in sequence and by sign, except the last, 
which must be positive. 

• An odd number of relocatable elements, as above, in combination with any number of 
absolute elements. 

Any combination of absolute or relocatable elements which does not result in either an abso- 
lute or relocatable value, by the rules above, results in an error. 

These rules and the rules for using t and can be summarized as — 



The expression is — 


The type is — 


Example 


absolute ± absolute 


absolute 




absolute + relocatable 


relocatable 




relocatable ± absolute 


relocatable 




relocatable - relocatable 


absolute 


;:, rr, r, 1 1 


relocatable + relocatable 


error 




absolute - relocatable 


error 




absolute * absolute 


absolute 




absolute /absolute 


absolute 




absolute * relocatable 


error 




relocatable * absolute 


error 




absolute / relocatable 


error 




relocatable/absolute 


error 


3 /Temp 
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Unlike BASIC, there is no precedence among the operators. All are of equal precedence. 
Where precedence is desired, parentheses must be used. So where BASIC requires — 

2*16+3*8 

to result in 56, the same expression in the assembly language results in 280 (assembly language 
operators are evaluated from left to right). However, 56 would be the result if it were expressed 
as — 

(2*16) + (3*8) 

An expression may be of any length and contain as many operators and parentheses as desired, 
as long as the result can be evaluated and the parentheses are properly paired. All operators 
are evaluated from left to right. Multiplication and division can only be used with elements that 
are of type absolute. 

External Symbols and Elements 

There is an additional relocatable element, called "external". It behaves in almost all respects 
as does any other relocatable element, except that only one external item may appear in an 
expression. Also, the expressions containing — 

relocatable - relocatable 

are not allowed when one of the relocatable elements is external. Externals are defined as 
symbols appearing in an EXT pseudo-instruction — 



{symbol} [, {symbol} [,. ...] ] 

These are entry points in another module or utility. "Entry points" are merely symbols in a 
module which are listed in an ENT pseudo-instruction in that module — 

ENT {symbol} [, {symbol} [, ...] ] 

If one module contains — 



then that symbol would be available to another module which contains — 
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At execution time for a module with EXT instruction, all of the symbols listed in it must be either 
a utOity name or be contained in an ENT or SUB (described in Chapter 6) of another module. It 
is not necessary that the module be in source form; it may already be an object module 
assembled from a source module which contained the symbol as an ENT or SUB. 

Other Absolute Elements 

There are additional absolute elements which may be used in expressions. These are 
"machine addresses", short-precision numbers, and full -precision numbers. 

A machine address is one of the following — 

• An assembler pre-defined symbol. 

• A symbol associated with an EQU or SET pseudo-instruction whose expression is 
evaluated as a machine address (i.e., it contains a pre-defined symbol or another EQU- 
associated symbol whose expression contains a pre-defined symbol). 

For the most part, machine addresses can be used just like absolutes. However, they remain 
defined from assembly to assembly. By defining a machine address in one module (with an 
EQU or SET), it then becomes available to you with the same value in other modules which you 
assemble. 

For example, if you were to assemble a module containing — 



then RlOO is a machine address following the above rules, just as if the assembler had pre- 
defined it. If you don't do any SCRATCH or GET statements in the meantime, then the next 
assembly you do would also have this symbol available without ever having to define it. 

When full-precision numbers (like - 2.5, 3E3, 3.141592) and short-precision numbers (like 
IS, — 2.5S, 3. 14159S, 3E3S) are used in expressions, they become the entire expression. This 
is because these numbers are only intended as simple data-generating devices in literals and in 
DAT pseudo-instructions. Explicitly, the rules for using full- and short-precision numbers are — 

• They may only appear alone in an expression, i.e., they may not be in combination with 
other elements. 

• They may only appear in literals and in DAT pseudo-instructions. 
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Utilities 

A number of utilities have been provided to help make your programming tasks easier and to 
give you direct access to some of the operating system's capabilities and routines. 

Descriptions of the utilities are made in conjunction with those topics where the utilities play a 
part. The form of the description of a utility is somewhat standardized. Each description will tell 
you — 

• The name of the utility. 

• The general procedure for using the utility. 

• Any special requirements which must be satisfied for the utility to work properly. 

• A step-by-step calling procedure for the utility. 

• The exit conditions. 

Utilities are a form of subroutine, so to execute them it is necessary to execute a jump-to- 
subroutine instruction (JSM) if you want the utility to return to the routine which calls it. Most 
utilities execute a RET 1 instruction to return, so in some cases where you follow a utility call 
with a RET 1 of your own, you can save the RET instruction by using the JMP (unconditional 
branch) instruction instead. For example, a typical utility call looks like — 



but if it happened to be followed by a RET 1 — 
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the calling procedure could be changed to — 



and you save a word of code: the effect is otherwise the same. Check the exit conditions for a 
utility before using this approach. 

Utilities which you use in a module must have their names in an EXT pseudo-instruction for that 
module. Otherwise, the assembler is unable to tell that you meant a utility and not one of your 
own labels, causing an "undefined reference" assembly error. 

Appendix F contains a short description of the utilities and has cross-references to the location 
in the manual of the full discussion on each utility. 
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The utilities currently available are — 



Utility 


Description 


Busy 


Tests the busy bits of a BASIC variable 


Error exit 


Aborts an ICALL statement with a particular error number 


Get_bytes 


Accesses substrings (or parts of parameters) 


Get elem bytes 


Same as "Get bytes", but used for array elements 


Get_element 


Same as "Get value", but used for array elements 


Get file info 


Accesses the file-pointer of an assigned file 


Get_info 


Returns the characteristics of a variable passed as a 




parameter or existing in common 


Get value 


Returns the value of a BASIC variable 


Int to rel 


Data type conversion from integer to full -precision 


Isr_access 


Establishes hardware linkages for interrupts 


Mm_read_start 


Prepares to read a physical record from mass storage 


Mm read xfer 


Reads a physical record from mass storage 


Mm_write_start 


Writes a physical record to mass storage 


Mm write test 


Verifies a physical record was written to mass storage 


Printer select 


Changes or interrogates select-code for standard printer 


Print string 


Outputs a string to the standard printer . 


Put_bytes 


Replaces substrings (or parts of parameters) 


Put_elem_bytes 


Same as "Put bytes", used for elements in an array 


Put element 


Same as "Put value", used for elements in an array 


Put_file_info 


Manipulates the file-pointer of a file 


Put value 


Changes the value of a BASIC variable 


Rel_math 


Provides access to all the arithmetic routines 


Rel_to_int 


Data type conversion from full-precision to integer 


Rel_to sho 


Data type conversion from full -precision to short 


Sho_to rel 


Data type conversion from short-precision to full 
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Chapter O 

Arithmetic 



Summary: Arithmetic operations are reviewed and the arithmetic utilities are 
discussed. Floating point and BCD arithmetic are explained. 



Numerical calculations are a large part of any computer's operations. Implemented within the 
9835A/B's processor are both integer and primitive Binary Coded Decimal (BCD) floating- 
point arithmetic operations. This chapter deals with those operations and is intended for those 
readers who may have no acquaintance with this topic, or perhaps only a passing one. The 
particular machine instructions involved with such arithmetic are reviewed. 

Because the processor provides only rudimentary floating-point operations and because com- 
plete floating-point operations (e.g., subtract, divide) are not easy to write, utilities have been 
provided to perform these calculations. These utilities are discussed later in this chapter. If you 
are not interested in doing your own BCD arithmetic, it is recommended you skip immediately 
to "Arithmetic Utilities". 



Binary Coded Decimal (BCD) uses four-bit binary codes to represent decimal digits. Thus, the 
12-digit mantissa of a full -precision number is represented by 48 bits. The BCD digits are as 
follows — 



DECIMAL 


BCD 


. 


0000 


1 


0001 


2 


0010 


3 


0011 


4 


0100 


5 


0101 


6 


Olio 


7 


0111 


8 


1000 


9 


1001 
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A BCD number within this manual has its digits represented as Di, D2, Da, etc., with each digit 
corresponding to some BCD digit. Di is the most significant digit in a number. Since full- 
precison numbers within the 9835A/B contain 12-digit BCD mantissas, 12-digit BCD numbers 
are used as the most frequent examples in this discussion. In that case, D12 is the least signific- 
ant digit in a number. 

Arithmetic Machine Instructions 

There are some machine instructions which specifically operate upon the BCD registers. The 
discussions in this chapter will make use of the capabilities of these instructions to develop the 
techniques to write BCD arithmetic routines. If you have not done so already, you should 
familiarize yourself with the instructions before moving on in this chapter. A description of the 
instructions can be found in "Arithmetic Group" in Chapter 3. 



BCD Registers 



There are two registers in the machine used for BCD arithmetic — Arl and Ar2. These symbols 
are pre-defined by the assembly language to the registers' locations in memory (see Chapter 
3). The mnemonics for some instructions occeisionally refer to these registers as X and Y 
respectively (see Chapter 3). 

BCD Arithmetic 

To understand BCD arithmetic in the context of the 9835A/B, recall from Chapter 3 that a 
full-precision value is represented in four words which contain its information as follows — 



15 14 13 12 11 10 9 



1 Bit 



Exp| 1 1 1 1 1 1 t 1 
Signi Exponent 


1 1 1 1 




Man 
Sign 


Di 

(most significant digit) 


D2 


D3 


D4 


Ds 


De 


D7 


Da 


D9 


D10 


D11 


D12 

(least significant) 
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The exponent is stored in two's complement form. The exponent and the mantissa are always 
adjusted by arithmetic routines so that there is always an implied decimal point following Di. 
Thus, the mantissa of every value stored looks like — 

Di . D2 D3 D4 Ds De D? Ds D9 Dio Dn D12 

Except possibly for intermediate results within the individual arithmetic algorithms, the most 
significant digit of a full-precision value (Di) will never be unless the entire number is 0. 
Sometimes, after an individual arithmetic operation, the answer needs to be normalized, that 
is, the digits of the answer shifted to the left until Di is no longer 0. The exponent then needs to 
be adjusted to reflect the change. 

An important thing to keep in mind when examining BCD arithmetic, as implemented by the 
processor, is that mantissas are represented in a "sign-magnitude" format. This means that the 
absolute value is stored as the actual mantissa, and the sign of the mantissa is maintained 
separately. 

Addition 

There is a one-bit Decimal Carry (DC) flag within the processor which serves a BCD function 
similar to the Extend flag for binary addition. 

DC is set to a one or zero, depending upon the occurrence or absence of a carry from the 
addition of the two Di's of the two BCD numbers being added. Since mantissas are represented 
in a sign-magnitude form (with the sign in the exponent word rather than part of what gets 
added), DC represents an overflow for 12-digit mantissa additions. 

DC itself is part of the addition in the D12 position. This gives it potential use with 
multiple-precision floating point arithmetic. The addition process looks like this — 




= DC 



D2 



Da 



D4 



D5 



De 



D? 



De 



D9 D10 



Da I D3 i D4 I Ds I De 



D7 



Ds 



D2 D3 



D4 



DC 



D12 Arl 



D9 I D10 I D11 I Di2~| Ar2 



Ds I De D? Ds D9 D10 \ Dii~ D12 Ar2 



There are three instructions which concern themselves exclusively with DC. They are — SDS 
(Skip if DC set), SCD (Skip if DC clear), and CDC (Clear DC). 
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Ten's Complement for BCD 

The addition of the ten's complement of a number is used in lieu of a subtraction mechanism. If 
the signs of the two numbers to be summed are different, one of the numbers is complemented 
(it doesn't really matter which one), before the addition. 

The ten's complement of a number with n digits to the left of the decimal point is — 

X = lOn - X 

The ten's complement of a floating-point number has the same exponent as the original 
number. Since the mantissa (M) of a full-precision number can be assumed to have the decimal 
point implied after Di, then the number must be less than 10 (but greater than 0) and the ten's 
complement of a mantissa becomes — 

M = 10 - M 

Accordingly, all that is necessary to complement a floating-point number is to complement the 
mantissa. It is immaterial whether the mantissa is treated as a 12-digit integer or as a number 
between and 10; the same sequence of digits results. 

There are two instructions for doing ten's complements — CMX and CMY. The only difference 
between them is that CMX operates on the Arl register and CMY operates on the Ar2. 

CMX and CMY leave the exponent word of a full-precision number completely alone. This 
means that the sign of the mantissa and the entire exponent are left unchanged in a ten's 
complement by CMX and CMY. 
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Ten's complement helps to accomplish addition, too. Rather than go into all of the nuances and 
subtleties of the arithmetic process, there is a simple rule for accomplishing decimal summa- 
tions using ten's complements. Assuming the exponents are the same for the numbers to be 
added — 

• If the signs of the numbers are the same, simply add them and leave the signs alone. If DC 
occurs, the result (Ar2) must be shifted to the right one place, and the exponent adjusted. 

• If the signs of the numbers are different, complement, then add. A further complementing 
action may be necessary: if DC occurs, then the result necessarily has the same sign as 
the number which was not complemeted; if DC does not occur, then the result must be 
complemented and then given the sign of the number which was complemented. 

The FXA instruction is used to add mantissas. Here is a routine to implement the rule — 
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Floating Point Summations 

In the example just completed, you may have noted that to copy the sign the entire exponent 
word was copied. What if the exponents were different? The answer is — the exponents must 
have been the same. In fact, the only reason the example worked at all was that the exponents 
were the same. 

If exponents are different, addition of mantissas cannot proceed properly. To add the numbers 
it is necessary to make the exponents the same by shifting one of the mantissas an amount 
equal to the exponent difference. 

This difference is easily found by subtracting the smaller exponent from the larger. If the 
difference is eleven or less (the precision of the 12-digit mantissa), it is possible to offset the 
mantissa of the number with the smaller exponent. 

For example suppose there are two numbers to be added — 

X.XXXXXXXXXXX E6 
Y.YYYYYYYYYYY E4 

By shifting the smaller one to the right by 2 digits (the difference between 6 and 4), it is possible 
to align the exponents — 

X.XXXXXXXXXXX E6 
O.OYYYYYYYYYYYY E6 



Z.ZZZZZZZZZZZ E6 



As can be readily seen from the example, a shift of more than 11 digits would cause the smaller 
value to be all zeroes in the significant 12 digits. 

The digits to the right of the 12 most significant digits are lost in the action of shifting. That is, all 
except the left-most one. When using the MRX or MRY instructions, this digit is retained in the 
A register (bits 0-3) so that it can be used later for rounding purposes. 

To use the MRX or MRY instructions, the number of digits to be shifted must be present in the B 
register. 
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The process for this "justification" of exponents can be summed up as follows: 

• Subtract one exponent from the other storing the absolute value of the difference in the B 
register. 

• Execute the MRX shift if the Arl register is smaller; execute the MRY shift if the Ar2 
register is smaller. 

Normalization 

The raw result of an arithmetic operation (such as FXA) might not be a floating-point number 
that fits the standard form. It might have a leading DC needing to be incorporated into the 
number, as was seen in the "Addition" section earlier. Another possible deviation is a resulting 
Di of zero and no overflow. There could also be several zero-valued digits as left-most digits of 
the mantissa. 

Such situations call for "normalization". One type of normalization is accomplished with the 
NRM instruction. This instruction shifts register Ar2 left, leaving the number of shifts required in 
the B register as a binary number. The maximum number of shifts NRM performs is 12. If NRM 
must do all twelve shifts, Ar2 must have been 0. This is indicated by a value of 12 left in B and 
DC being set. For any other shift-count, NRM will leave DC at 0. 

The rules for the normalization process are — 

• Execute the NRM instruction. 

• Follow this instruction by adding the complement of the contents of B (shifted left 6 bits) 
to the Ar2 exponent unless DC is set. If DC is set, store into Ar2. 

• Test the exponent result for an underflow. 

Rounding 

The addition operation (FXA) does not automatically round a result, and there is no instruction 
which does rounding in one step. Instead, it is necessary that a series of instructions be estab- 
lished to accomplish the result. 

Recalling from "Floating Point Summations" (above) that the leftmost digit for rounding pur- 
poses (if any) is typically deposited in the A register by an MRX or MRY instruction, this digit 
can be checked to determine if rounding is required. 
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The process of rounding, then, would have the following steps — 

• Determine from register A if rounding is required (i.e., if it's greater than or equal to 5). 

• If rounding is not required, take no further action. If rounding is required, then load 
register B with 1 and execute an MWA instruction. This has the effect of incrementing the 
mantissa in Ar2 by 1. This action is an easier method than setting Arl to 1 and executing 
an FXA and it's faster, too. Don't forget to check DC for an overflow. 

• One way the sequence of rounding could appear is — 



Floating Point Multiplication 

Twelve-digit BCD floating-point multiplication is partially accomplished using the FMP instruc- 
tion. This instruction effectively multiplies the value in the Arl register by a digit contained in B 
and adds the result to a partial product in Ar2. 

Since, in the full multiplication process, exponents are merely added together, that part of the 
process is trivial. The ultimate sign of the product is also a trivial matter, determined by 
inspection of the signs of the original operands. Then the only matter of difficulty in the process 
is the actual multiplication of the mantissas. By way of explanation, assume that there are two 
mantissas to be multiplied — 

multiplicand = A B C D 
multiplier = W X Y Z 

Just four digits are used to reduce the amount of symbolism required of the example. The same 
procedures and conclusions are applicable to a full twelve BCD digits. 
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One symbolic way to indicate how this multiplication is done is — 

A B C D 
X W X Y Z 



0= partial product 
Zi Z2 Zs Z4 = Z(ABCD)xlO° 



P4 Ps Pe P? Ps = partial product 1 
Yi Y2 Ya Y4 = Y (ABCD) x 10^ 



Ps P4 Ps Pe P? Ps = partial product 2 
Xov Xi X2 Xs X4 = X (ABCD) x 10^ 

P2 Pa P4 Ps P6 P? Ps = partial product 3 
Wov Wi W2 Ws W4 = W (ABCD) x 10^ 

Pi P2 P3 P4 Ps Pe P? Ps = partial product 4 (result) 

Notice that at each stage the multiple of ABCD, such as X(ABCD), must be multiplied by an 
increasing power of ten in order that the digits of the multiple line up appropriately with the 
digits of the last partial product. An equivalent procedure is to have the partial product shifted 
right one digit at each stage. 

Now, consider for a moment what is necessary within the assembly language to generate partial 
product 1 = + Z (ABCD). Ar2 must be cleared and Arl is loaded with ABCD. Z is stored into 
B in bits to 3. Then the FMP instruction is executed. Arl is added to Ar2 Z times, producing Z 
(ABCD) in Ar2. The overflow digit, Zov, ends up in the A register (bits to 3). The overflow digit 
could be any value from to 9 (each add could cause a carry, and there can be up to nine 
additions). 

To create the next partial product, a mantissa right-shift on Ar2 must occur. Notice that man- 
tissa right-shifting instructions (MRX and MRY) also shift bits to 3 of the A register into Di. 
Thus, the right-shifting of the partial product (which must occur to prepare Ar2 for the next 
partial product) also automatically takes care of retaining the overflow digit. 

Next, ABCD is added to Zov Zi Z2 Zs a total of Y times (again by use of the FMP instruction). 
Partial product 2 is created. The process is repeated for the X and W digits, producing the result 
in Ar2. 
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After the final partial product has been calculated by the final execution of the FMP instruction, 
it is possible that a non-zero digit may be present in bits 0-3 of the A register. Such a digit is 
necessarily the most significant digit of the final product. In this case, another MRY execution is 
required. Further, the exponent of the product (which was initially estimated as the sum of the 
operand's exponents) must be incremented by one to reflect this power-of-ten shift. 

Upon each step of partial product summation, a significant digit is lost due to the shift. This 
can't be helped. In general, the product of two 12-digit numbers has 24 digits of precision, but 
the bottom 12 digits must be discarded since only 12 BCD digits are stored in a mantissa. An 
error analysis of the algorithm discloses that dropping these digits causes the answer, on 
average, to be slightly smaller than it should be. However, rounding introduces a similar error, 
but in the other direction. Note that the process did not round each partial product. 

The discarded digits can be inspected before they are permanently lost. The MRY instruction 
causes the digit to be placed in the A register (in bits to 3). This provides an easy way for a 
rounding mechanism to check on those digits as they are discarded. The rounding routine 
needs to save the last digit discarded for use in rounding in the event the last use of FMP 
produces no overflow digit. 

Finally, it should be noted that you can put WXYZ into B at the very start of the process and 
simply shift B right 4 bits (with an SBR 4 instruction) between each execution of FMP. After all, 
FMP uses only bits to 3 of the register as the number of times to add Arl and Ar2. 

Floating Point Division 

There are many possible algorithms to accomplish floating-point division. The one presented 
here was chosen because of its effective use of the machine instructions and data structures 
employed by the processor and operating system. 

Remembering that full -precision numbers consist of both a signed mantissa and a signed 
exponent, use can be made of the mathematical properties of both to reduce the division 
problem to manageable proportions. Suppose that you have two full-precision values to 
divide — 

- 4.8E3 ^ 1.5E - 2 
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The mathematical properties of exponents can be utilized and the second exponent can be 
subtracted from the first giving the exponent of the answer (subject to possible later adjust- 
ment). This is the first (and easiest) step in the division algorithm. 

Secondly, the mathematical properties of signs within a division process can be used to deter- 
mine the sign of the quotient from the signs of the divisor and dividend (negative quotient if the 
signs are different, positive quotient otherwise). 

Thus, the problem can be reduced to the division of the mantissas — 

(-4.8- 1.5) E5 

As long as the full-precision numbers have been normalized, this adjustment of the exponents 
works for any pair of exponents. The normalization of the numbers also assures that the 
division of the mantissas under the following algorithm is sufficient to produce the mantissa of 
the result. 

Since the decimal point of each mantissa is in the same place, they can be dropped altogether. 
For example — 

- 4.8 ^ 1.5 = - 48 H- 15 

The algorithm can then consider both the divisor and the dividend as 12-digit integers. 

The algorithm begins by placing the normalized values into the BCD arithmetic registers. The 
divisor (1.5E2 in the example) is transferred to register Arl. The dividend (- 4,8E3 in the 
example) is transferred to register Ar2. Basically, the algorithm subtracts the absolute value of 
the mantissa of Arl from the absolute value of the mantissa of Ar2 until Ar2 is smaller than Arl. 
The number of subtractions required for that to occur becomes the first digit in the quotient (it'll 
be some value between and 9 because the mantissas are normalized). If there is a (non-zero) 
remainder, then it is shifted left (multiplied by 10) and the subtraction process is repeated to 
calculate another digit in the quotient. The process is repeated until either a zero remainder 
occurs , or sufficient digits have been calculated, whichever occurs first. The resulting digits are 
merged, in order, to form the complete mantissa of the quotient. 
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There are some points to keep in mind in following the algorithm — 

• Suppose you have a divisor whose normalized mantissa is larger than the normalized 
mantissa of the dividend, for example — 

15-48 

then the first digit of the quotient's mantissa could easily be zero. If calculation of only 
twelve digits were made, the first digit being zero would mean a loss of a significant digit. 
To guarantee that there are always at least 12 significant digits calculated for the quotient, 
it is necessary (and sufficient) to calculate 13 digits. The 13th digit can always be thrown 
away, or used for rounding, if the first digit is not zero. Thirteen digits are always sufficient 
because you can never have a quotient with two leading zeroes, if the divisor and the 
dividend are both normalized. 

• The number of subtractions during the calculation of any digit in the quotient is always 
nine or less. Again, this is true because the divisor is normalized and its first digit is always 
non-zero. 

• At times during the algorithm, it is necessary to left-shift the mantissa of Ar2 (the mantissa 
at this point is the remainder). When shifting the remainder to the left (multiplying it by 
10), you are shifting the first digit out of Ar2. If this digit is zero, this is not a problem. But, 
if the digit is non-zero, you can't ignore it during subtractions of the divisor. This in effect 
means that you are dealing with a 13-digit dividend! Since the machine instructions deal 
in 12-digit arithmetic, it is necessary that the algorithm handle the thirteenth. 

The FDV Instruction 

The FDV instruction provided by the processor is the primary tool used to implement the 
algorithm in assembly language. The instruction works by accomplishing the equivalent of 
automatically repeated subtractions of Arl (the divisor) from Ar2 (the dividend) until Ar2 is 
smaller than Arl. The instruction actually adds the divisor to the ten's complement of the 
dividend until an overflow occurs. However, this is equivalent to subtracting until an "under- 
flow" occurs. It is easier to understand the procedure if the discussion is in terms of "subtrac- 
tions", but it should be kept in mind that what is really occurring with the instruction is repeated 
"complement-additions" until overflow. This process is what is meant by the term "subtrac- 
tions until overflow". 
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The FDV instruction returns the number of subtractions without overflowing as a binary 
number in the B register (bits 0-3). The remaining bits in the B register (4-15) are cleared.^ In 
effect, then B contains the next digit in the quotient. 

This process is repeated for the number of digits to be calculated. After each FDV execution, 
the result of the overflow subtraction is left in Ar2. Since Ar2 does not contain the remainder, it 
is necessary to patch Ar2 so that it will contain the proper value for the next calculation. To get 
the proper value it is necessary to add Arl back into Ar2 to undo the results of the last 
subtraction (which caused the overflow).^ 

There is one case, however, where Ar2 does not need to be patched up, and this is when the 
remainder (Ar2) is zero. This situation implies not only that no patching up is needed, but also 
that the quotient is complete — no further digits need be calculated. It should be noted that the 
number of subtractions (which has been stored in the B register) is one count too small, thus B 
has to be incremented in this case so that it can be used as the last digit in the quotient. 

Thirteen-Digit Dividends 

The largest difficulty in the algorithm is attempting to deal with those instances where the 
dividend has thirteen digits. This situation arises when you shift the remainder left a place. The 
most significant digit must be retained when it is non-zero so that the subtractions are sub- 
tracted from the proper amount. 

This shifting can be accomplished with the MLY instruction. With the way that the MLY instruc- 
tion operates, the left-most digit (Di) ends up being shifted out of Ar2 into register A (in the 
lower 4 bits, 0-3). Thus, the thirteen-digit algorithm must accomodate the most significant digit 
residing in the A register and the twelve least significant digits in the Ar2 register. The use of 
FDV must now take this modified situation into account. 

When the FDV instruction is executed, Arl is subtracted from Ar2 until an overflow occurs. 
When this overflow occurs, it is necessary to decrement A and keep subtracting (without 
patching up Ar2). Each time an overflow occurs, A must be decremented until finally an 
overflow occurs when A is 0. This can be handled very neafly within a small loop. 



1 Since bits 4-15 of the register are cleared during execution of the FDV instruction, you can't accumulate quotient digits there. 
After each digit is calculated, it is necessary that you store the digit as part of a quotient which you keep stored in another 
location. / 

2 This is equivalent to complementing Ar2, adding in Arl, then complementing Ar2 again. 
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Another aspect of dealing with thirteen-digit dividends is the count placed in B with each 
execution of FDV. Since each overflow is a "successful" subtraction in the sense that is part of 
a proper count of subtractions (at least until A is 0), then that subtraction must be counted, too. 
The difficulty with this is that FDV does not count this last (overflowing) subtraction. The 
solution obviously is to add 1 to the value in the B register each time FDV causes an overflow. 
However, with the last overflow, being the "real" overflow, the 1 shouldn't be added in, so 
after adding it in (during the loop), you have to subtract it back out again (after leaving the 
loop). To further complicate matters, if you have a zero remainder, you have to add it right 
back in again. 

For example, if there happened to be three uses of FDV for a certain quotient digit, you form 
the quotient digit as — 

Qn = (B + l)^ +(B + l)w +Bw 

\ \ \ 

value after 1st value after 2nd value after final 

use of FDV use of FDV use of FDV 

If the same general situation produced a zero remainder, then the quotient digit is formed as — 

Qn = (B + l)w +(B + 1) +(B + 1)^ 

value after 1st value after 2nd value after final 

use of FDV use of FDV use of FDV 

Floating-Point Division Example 

An example of a 13-digit division routine follows. The rules which it implements are — 

1. Always increment the value returned in B after an FDV operation. 

2. After incrementing B, check the contents of A. If non-zero, loop immediately, performing 
no other tests or activities. 

3. When a quotient digit has been found (i.e., A is zero), check to see if the remainder is 0. 
If so, exit the division loop. Save the last digit found as part of the answer. 

4. If the remainder is not 0, decrement the value of the last quotient digit found and save it 
as part of the answer. Then add back the divisor to the remainder. 
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The example does not include routines for testing and handling — 

• signs 

• division by zero 

• exponents 

• overflow 

• rounding 



These have to be handled in a real program before or after the division algorithm itself (as 
appropriate). 
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Arithmetic Utilities 

Now that you have been introduced to the complexities of BCD arithmetic and floating-point 
operations, this is the time to present an easier way of accomplishing these operations — the 
arithmetic utilities. 

In order to make BASIC a useful programming tool, the operating system already contains a 
number of floating-point routines. Recognizing that BCD and floating-point arithmetic can be a 
difficult and laborious task to implement, the assembly language provides a utility by which the 
operating system mathematical routines can be accessed. There are also utilities for the conver- 
sion of numerical data types. 

UTILITY: Relmath 

The Rel_math utility provides access to all of the system floating point routines and functions. 

General Procedure: The utility is told the execution address of the desired routine or function 
and is also told the number of parameters. The parameters are floating-point values stored in 
full-precision form (4 words each). The result is a full -precision value. 

Special Requirements: 



• If one operand is passed to the utility, the address of the operand is stored in register 
Oper_l. 

• If two operands are passed to the utility, the address of the first operand is stored in 
register Oper_l (as above), and the address of the second operand is stored in register 
Oper_2. 

• The address of where the result should be stored must be stored in the register Result. 

• All operands and the result are full-precision values and require 4 words each. 
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• Values passed must make sense for the routine or function being called (e.g., Oper_2 
should not point to a value of when calling the division routine), or else an error results. 

• The storage areas for the operands and the result must reside either in the ICOM region or 
in the Base_page register. Specifically, they cannot be specified as Arl or Ar2. 

Calling Procedure: 

1. Assure that Oper_l, Oper_2, and Result contain the proper addresses as above. 

2. Load register A with the number of parameters required for the routine or function (see 
the table on next page). Note that some routines require this number to be com- 
plemented. 

3. Load register B with the execution address of the routine or function (see the table on 
the next page). 

4. Call the utility. 
Exit Conditions: 

• The result is placed into the 4 words starting at the address pointed to by the Result 
register. 

• Register A contains if no error is encountered during execution of the utility. 

• Register A contains the error number should an error be encountered during execution of 
the utility. 
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Table 1. Routines, Addresses, and Parameters for Rel Math Utility 



Routine 


Execution Address 


Operands 




(LDB = ) 


(LDA = ) 


Addition 


30620B 


2 


Subtraction 


30612B 


2 


Multiplication 


30732B 


2 


Division 


31100B 


2 


Exponentiation 


34066B 


2 


DIV 


32574B 


2 


MOD 


32725B 


2 


SQR 


31240B 


1 


INT 


32637B 


1 


FRACT 


33052B 


1 


EXP 


33763B 


1 


LOG 


33773B 


1 


LGT 


34053B 


1 


PROUND 


32015B 


-2 


DROUND 


32037B 


-2 


ABS 


32622B 


1 


SGN 


33441 B 


1 


PI 


36057B 





RND 


33377B 





RES 


36077B 





TYP 


6733B 


1 


SIN 


34003B 


1 


COS 


34014B 


1 


TAN 


33741B 


1 


ASN 


34025B 


1 


ACS 


34040B 


1 


ATN 


33751B 


1 


ERRL^ 


61765B 





ERRN> 


61753B 





DECIMAL' 


162026B 


1 


lADR 


162167B 


-2 


IMEM 


162150B 


-2 


OCTAL 


162105B 


1 


AND 


31632B 


2 


OR 


31647B 


2 


EXOR 


31615B 


2 


NOT 


31661B 


1 


Less Than (<) 


31667B 


2 


Less Than or Equal To (< = ) 


31675B 


2 


Not Equal (<>) 


31727B 


2 


Equal ( = ) 


31717B 


2 


Greater Than or Equal To (> = ) 


31711B 


2 


Greater Than (>) 


31703B 


2 



1 These functions return an integer value which is stored in the second word of the four words reserved by Result. 
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By way of example, suppose you have established two full -precision values which need to be 
multiplied. The call to the Rel_math utility to accomplish the multiplication would look similar 
to this — 






t i f j 1 
LDR 



urn 



! HULTiPLV THE OPERAND:: 



Ca1 









Note in the last line of the example the call to the Error_exit utility (page 191) is made when 
register A is not zero. When this occurs, A contains the error number of the error 
encountered — ready-made for calling the Error_exit utility. 

UTILITY: Reltoint 

The Rel_to_int utility provides for the conversion of a full-precision value into an integer. 

General Procedure: The utility is given the address of the location of the full -precision value 
and the address of the location where the integer is to be stored. 



Special Requirements: The full-precision value must be within the range of integers 
(-32 768 to + 32 767). 
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Calling Procedure: 

1. Store the address of the full -precision value into register Oper_l. 

2. Store the address of where the integer is to be stored into register Result. 

3. Call the utility. 

Exit Conditions: The overflow bit in the processor is set if the integer is outside the range of 
integers. 

An example — 






UTILITY: Reltosho 

The Rel_to_sho utility provides for the conversion of a full-precision value into a short- 
precision one. 

General Procedure: The utility is given the address of the location of the full-precision value 
and the address of the location where the short-precision value is to be stored. 

Special Requirements: A short-precision value requires 2 words to be stored. 

Calling Procedure: 

1. Store the address of the full-precision value into register Oper_l. 

2. Store the address of the storage area for the short-precision value into register Result. 

3. Call the utility. 



Exit Conditions: No special exit conditions. 
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As an example — 



UTILITY: Inttorel 

The Int_to_rel utility provides for the conversion of an integer into a full-precision value. 

General Procedure: The utility is given the address of the location of the integer and the 
address where the full-precision value is to be stored. 

Special Requirements: None. 

Calling Procedure: 

1. Store the address of the integer into register Oper_l. 

2. Store the address of the storage area for the full-precision value into register Result. 

3. Call the utility. 

Exit Conditions: No special exit conditions. 



An example — 



Arithmetic 105 



UTILITY: Shotorel 

The Sho_to_rel utility provides for the conversion of a short-precision value into a full- 
precision one. 

General Procedure: The utility is given the address of the location of the short-precision 
value and the address of where the full -precision value is to be stored. 

Special Requirements: None. 

Calling Procedure: 

1. Store the address of the short-precision value into register Oper_l. 

2. Store the address of the storage area for the full-precision value into register Result. 

3. Call the utility. 

Exit Conditions: No special exit conditions. 



An example — 
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Chapter O 

Communication 
Between BASIC and 
Assembly Language 



Summary: This chapter discusses the techniques used to pass information to and from 
assembly language programs. Calling assembly language routines and passing paramet- 
ers are presented, along with issues involved in using common. Applicable utilities are 
also discussed. 

Once assembly language programs have been written, they are executed using the ICALL 
statement. This statement is very similar to BASIC'S CALL statement for subroutines. In fact, 
the function it performs is nearly identical in effect — the only difference is that the target 
subroutine has been written in assembly language instead of in BASIC. The ICALL statement 
also provides a means to pass data between BASIC and assembly programs through its argu- 
ment list. Data can also be passed through common. 

The ICALL Statement 

There are two ways to execute an assembly language routine. One way is as an interrupt service 
routine when an interrupt occurs on the select code to which the service routine has been 
linked. This way is discussed in Chapter 7. The other way is through executing an ICALL 
statement, either in a BASIC program or from the keyboard. 

The syntax of the statement is — 

ICRLL {routine name} [ ( {argument} [, {argument} [,...]] ) ] 

{routine name} is the name of the assembly language routine to be executed, {argument} is a 
data item which has the same characteristics as an argument in BASIC'S CALL statement — 
there may be constants, variables, or expressions. (How these items correspond to instructions 
in the assembly language will be discussed shortly.) 
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By way of example, suppose that you have an ICALL which is being used to call a sort routine 
and the routine was written in such a way as to require two arguments be passed to it — an 
array to be sorted and the number of elements to be sorted (in that order). Then the following 
would be valid calls to that routine — 



Upon executing the ICALL statement, execution in a program transfers to the routine named. 
Upon return from the routine, control is passed to the BASIC statement which follows the 
ICALL. This is identical in effect to the CALL statement in BASIC. 

In executing the statement from the keyboard, the routine named is executed just as if it were 
used in a program. Upon return from the routine, control is passed back to the keyboard. This is 
unlike BASIC'S CALL statement, which cannot be executed from the keyboard. 

To execute a routine, whether it be from a program or from the keyboard, its object code must 
currently reside in the ICOM region. 

Corresponding Assembly Language Statements 

When the ICALL is executed, it references a routine in the object code. When the module 
containing the routine was assembled, it declared that routine name as a "subroutine" entry 
point. ("Subroutine" and "routine" are synonymous in this context.) This is done with a SUB 
pseudo-instruction and a label. 

When a SUB pseudo-instruction appears in the source code, it is a signal to the assembler that a 
subroutine entry point follows. Then the first machine instruction (or some code-generating 
pseudo-instruction, such as BSS or DAT) must have a label. That label becomes the routine 
name. If the label is missing, an error results (assembly-time "SQ" error). 

For example, in the above examples of ICALL, the Sort routine could have been defined by the 
sequence — 



except that there are arguments involved. (That exception is discussed in a moment.) The joint 
use of these two statements results in the label "Sort" being identified as a routine name, 
referenceable with an ICALL statement. 
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In general, no machine instructions or code-generating pseudo-instructions can be inserted 
between a SUB pseudo-instruction and the instruction containing the routine name. An excep- 
tion to this exists when arguments are involved in a call. 

Arguments 

When a value is placed into an ICALL statement to be sent down to an assembly language 
routine, that value is called an "argument" (like the argument of a mathematical function). The 
corresponding structure on the assembly language side is called a "parameter". A parameter 
"declaration" is an assembly pseudo-instruction by which a parameter is created. 

When a routine is to be called with arguments, a parameter declaration pseudo-instruction is 
required for each one of the arguments. These declarations appear between the SUB pseudo- 
instruction and the instruction containing the routine name. 

Thus, when there is a call like — 



the corresponding assembly language entry looks like — 



To accommodate the two arguments, two parameter declarations had to appear between the 
SUB instruction and the entry point. (In this example, they were the STR and REL declara- 
tions.) These declarations may even have labels of their own — 



The appearance of these labels does not effect the fact that "Sort" is the name of the routine. 
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Parameter declarations have "types" just like variables. These types have to correspond to the 
"types" of the arguments used in the ICALL. The declarations and their types are — 

meaning integer 
meaning full -precision 
meaning short-precision 
meaning string 
meaning a file number 

In the above example, STR had to be used as the first parameter declaration because the first 
argument was a string. Similarly, REL had to be the second declaration because the second 
argument was a numeric expression (which is always full-precision). 

When an array is to be passed, the declaration is followed by an "array identifier" — (*). Thus, 
when arrays are involved, the declarations appear as — 



meaning an integer array 
meaning a full-precision array 
meaning a short-precision array 
meaning a string array 

(File numbers do not come in arrays, so that declaration — FIL — cannot be followed by an 
array identifier.) 

Since the example call above uses a string array as the first argument, the corresponding 
assembly language parameter declaration uses an array identifier after STR. 

The parameter declarations are associated with the arguments in the ICALL in the same order. 
If the types do not match when the ICALL is executed, an error occurs (number 8). 

So, if the subroutine entry looks like — 
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then this ICALL executes properly — 



but these ICALLs result in run-time errors 






Each declaration reserves three words in the object code upon assembly. As a result of the 
ICALL execution, these words contain a descriptor of the corresponding argument. These 
descriptors are used by the utilities for fetching and storing values. Thus, in the Sort calling 
example above, when the ICALL is executed, a descriptor for Test$(*) is stored in the three 
words starting at Parameter_l. Similarly, a descriptor for the constant 100 is stored in the three 
words starting at Parameter_2. 

The types discussed here do not apply just to simple variables, arrays, and constants. They also 
apply to single elements of arrays and expressions. If you have a STR parameter declaration, 
for example, any of the following would be valid as arguments in the ICALL statement — 



It is similar for numerical expressions. 

The number of arguments passed by an ICALL statement must be no more than the number of 
parameter declarations in the subroutine entry. There may be fewer, however. The actual 
number passed is stored in the word reserved by the SUB pseudo-instruction. 

Unlike the CALL statement in BASIC, the ICALL statement can be executed from the 
keyboard. In doing so, any variables used as arguments pass their current values to the routine, 
rather than resetting them to (this is the same contrast as between running a program by 
pressing [^ and running it pressing \^^). 
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"Blind" Parameters 

With explicit parameter declarations, an error occurs if a different type of variable or expression 
is passed. In many cases, the error is desirable — you do not want different types of arguments 
corresponding to a single parameter declaration. But in other cases, the error might not be as 
desirable. Take the example of a sort. You might want the sort to have the capability of sorting 
any type of array. You have two choices in that case — you can make different routines, each 
with the appropriate declarations, or you can use a single entry point and the ANY parameter 
declaration. 

The ANY declaration — 



is "blind" to the type of the corresponding argument in the ICALL statement. When used, it 
accepts any type of argument as valid — string, full-precision, short-precision, integer, file 
number, array. The descriptor for the argument is stored in the three words set aside, just as in 
the other declarations. 

Now, if your entry looks like — 



then any of the following calls would be valid 



When using the ANY declaration, it becomes the responsibility of your assembly language 
routine to determine what is a valid parameter and what is not. You lose the automatic type- 
checking available with explicit declarations. Techniques for doing this are discussed in the 
next section. 
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Getting Information on Arguments 

When an ICALL is executed with an argument, and the corresponding parameter is blind, then 
it may be necessary for the purposes of your routine to know what type of argument is actually 
passed. This need can be present even when one of the explicit type declarations is used, since 
an expression or constant can be passed as easily as a variable. 

A utility has been provided for obtaining this information, along with other "vital statistics" 
which may be useful to know during the execution of your routine. Before describing the utility 
itself, let's look at the information which it can provide you about an argument. 

The information returned by the utility is stored in an area which you set aside for it. The size of 
the area can vary from 3 words to 30. The information, when returned, is in the following 
form — 



Word# 



Description 



Argument type (see description later) 

Number of dimensions (0 for non-arrays) 

Size, in number of bytes (dimensioned length, for strings) 



(for arrays only: ) 

3 Total number of elements in array^ 

4 Lower bound of first dimension^ 

5 Absolute size of first dimension (upper bound — lower +1) 

6 Lower bound of second dimension (if any)^ 

7 Absolute size of second dimension 

8 Lower bound of third dimension (if any)^ 

9 Absolute size of third dimension 

10 Lower bound of fourth dimension (if any)^ 

11 Absolute size of fourth dimension 

12 Lower bound of fifth dimension (if any)^ 

13 Absolute size o^ fifth dimension 

14 Lower bound of sixth dimension (if any)^ 

15 Absolute size of sixth dimension 

16 Element offset 

17 Size, in words, of each element (dimensioned length, for strings) 

(dependent upon memory size of your machine:) 



18-20 
21-23 
24-26 
27-29 



Pointer parameters 

Pointer parameters (only for machines over 64K bytes) 
Pointer parameters (only for machines over 128K bytes) 
Pointer parameters (only for machines over 192K bytes) 



1 Stored as a negative number. 
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The argument type returned in word is as follows — 



Value 


Type 





String expression 


1 


Full-precision expression 


2 


Short-precision expression 


3 


Integer expression 


4 


String simple variable 


5 


Full-precision simple variable 


6 


Short-precision simple variable 


7 


Integer simple variable 


8 


String array element 


9 


Full-precision array element 


10 


Short-precision array element 


11 


Integer array element 


12 


String array 


13 


Full -precision array 


14 


Short-precision array 


15 


Integer array 


16 


File number 



The size, in bytes, will be one of the following values — 



For an integer 


2 


Short-precision 


4 


Full-precision 


8 


String variables 


dimensioned length 


String expressions 


actual length 



The utility which retrieves all this information is called "Get info". 



UTILITY: Getinfo 

General Procedure: The utility is told the location where the information is to be returned 
and the address of the parameter declaration. It returns with the information on the argument 
in the ICALL corresponding to the parameter declaration. 
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Special Requirements: 

• The location where it is to store the information must be adequate to hold all that may be 
returned. For non-arrays, 3 words will suffice. For arrays, up to 30 words may be required 
(as above). If you are writing a general routine, it may be wise to play it safe by setting 
aside a full 30 words. 

• An argument must have been passed by the ICALL (in the case of parameters) or a 
corresponding BASIC COM declaration must exist (in the case of common declarations). 

Calling Procedure: 

1. Load register A with the address of the storage area for the information to be returned. 

2. Load register B with the address of the parameter declaration corresponding to the 
desired argument. 

3. Call the utility. 

Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the JSM. Since there are no error exits, and there is no requirement that there be as 
many arguments as there are parameter declarations, an argument must actually have been 
passed by the ICALL in order for the utility to work correctly. 

Following up on the example in the previous section, suppose the first thing that the Sort 
routine does is check to see if the first parameter passed is an array. Then, by using the 
Get info utility, it is possible to have the instructions look as follows — 



a;i::: 
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The array information returned by the Get_info utility is used for accessing elements in arrays 
passed as arguments. It is used by the element-retrieval utilities described in a later section of 
this chapter. Once retrieved, the information is usable any number of times for accessing the 
array associated with it. It is not necessary to retrieve the information every time you access an 
array, as long as you have not altered the information (except the pointer) between accesses. 

The seventeenth word of the array information (word 16 on the chart) is reserved to hold the 
offset from the start of the array of the element to be accessed. Therefore, it is permissible 
(indeed, it is necessary) to alter the contents of that location to indicate which element in the 
array you wish to retrieve. None of the other words returned by the utility should be changed. 

In making multiple accesses with the same information, caution should be taken when an array 
is involved. If a REDIM statement is executed upon the array between accesses, the information 
may not reflect the true structure of the array. This potentiality can be addressed in one of two 
ways — 

• Advise the BASIC user against using a REDIM on the array between executions of the 
routine or routines involved. 

• Call the Get_info utility each time the array is accessed. 

Similar problems exist when a BASIC subprogram is called recursively, and the subprogram 
uses a local array as an argument in an ICALL, or when a subprogram calls a routine and later 
exits (causing its local arrays to disappear). 

Retrieving the Value of an Argument 

At some point during execution of your assembly language routine, you may want to retrieve 
the value of an argument so that you can use it in your processing. By doing so, you accomplish 
one of the methods of communicating with assembly language — namely, passing a value TO 
the assembly language routine from BASIC. 

There are a number of utilities for this purpose. The one to use is dependent upon the type of 
argument passed. The utilities available are — 



Name 



Get_value 

Get_element 
Get_bytes 

Get elem bytes 



Used For 



Simple variables, expressions, individual elements of 
arrays passed as arguments, and file numbers 

Elements (from arrays passed as arguments) 

Substrings of strings passed as arguments either as 
simple string variables, expressions, or individual 
elements of arrays passed as arguments 

Substrings of individual elements (from string arrays 
passed as arguments) 
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How each of these utilities is used is described in the immediately following pages. 

UTILITY: Getvalue 

General Procedure: The utility is given the address of the parameter declaration and the 
address of where the value of the argument is to be stored. It returns with that value stored in 
the indicated area. It works on simple variables, expressions, and individual elements of arrays 
(passed as arguments), of any type. 

Special Requirements: 

• The storage area set aside for the value must be large enough to hold the value. The size 
of the storage area must be — 

for a file number 1 word 

for an integer value 1 word 

for a short-precision value 2 words 

for a full -precision value 4 words 

for a string maximum length in bytes -r 2 -I- 1 word 

(+ 1 additional word if the string length is odd) 

• An argument must have been passed by the ICALL for the utility to work properly. 
Calling Procedure: 

1. Load register A with the address of the storage area for the value. 

2. Load register B with the address of the parameter declaration. 

3. Call the utility. 

Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the call. 

Here is an example call to the utility, retrieving information from a full-precision argument — 
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UTILITY: Getelemcnt 

General Procedure: This is similar to the "Get_value" utility. This utility retrieves a value 

from an element of an array passed as an argument. It works on arrays of any type. 

Special Requirements: 

• The storage area set aside for the value must be large enough to hold the value. Resultant, 
the size of the storage area must be — 

for an integer 1 word 

for a short-precision value 2 words 

for a full-precision value 4 words 

for a string maximum length in bytes 2 -I- word 

(+ 1 additional word if the string 

length is odd) 

• The array information must be retrieved with the "Get_info" utility before calling this 
utility. 

• The offset of the element in the array must be correct in the array information (word 16 
returned by "Get_info"). It should be remembered that the offset of the element is 
dependent upon the number of dimensions in the array and the length of each. A calcula- 
tion may be necessary to arrive at the offset when accessing multiple-dimension arrays. 
The offset is in terms of number of elements. 

Calling Procedure: 

1. Store the element offset within the array information (word 16 returned by "Get-info"). 

2. Load register A with the address of the storage area for the value. 

3. Load register B with the address of word of the information returned by the 
"Get_info" utility (see description of that utility). 

4. Call the utility. 

Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the call. 
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Here is an example call, retrieving the third element (relative element 2) of an integer array and 
placing it into Value — 



h3.ra.ri!et 



UTILITY: Getbytes 

General Procedure: This is similar to the "Get_value" utility. This utility retrieves a substring 
of a string passed as an argument, having been given the starting byte and the number of bytes 
to be retrieved. 

Special Requirements: 

• The storage area set aside for the substring must be large enough to hold all of the 
substring. This includes not only the string itself, but also two extra words. Remember, a 
word holds two characters. 

• A string must have been passed by the ICALL for the utility to work properly. 
Calling Procedure: 



1. Store the number of the starting byte of the substring desired into the first word of the 
storage area set aside for the substring. (Note that bytes and 1 are the length word of 
the string.) 

2. Store the number of bytes in the substring into the second word of the storage area. 

3. Load register A with the address of the storage area. 

4. Load register B with the address of the parameter declaration. 

5. Call the utility. 
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Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the call. The substring is returned starting with the third word of the storage area. 
(Note: Since the second word contains the length of the substring, you have a string data 
structure starting with the second word!) 

For example — 






In this example, Value is the storage area. Since 2 has already been generated and stored in the 
first word, and 10 in the second, the first 10 bytes of the string would be transferred. Of course, 
the original string must contain at least 10 characters — or the bytes which are returned may be 
nonsense. Why was the value 2 stored as the byte number? Because bytes in a string are 
numbered starting with 0, and bytes and 1 contain the length of the string (see "Data 
Structures" in Chapter 3). 

UTILITY: Getelembytes 

General Procedure: This is a combination of the "Get_element" and "Get_bytes" utilities. 
This utility retrieves a substring of an element of a string array passed as an argument. The 
utility is given the starting byte and the number of bytes to be retrieved. 

Special Requirements: 

• The storage area set aside for the substring must be large enough to hold all of it. This 
includes not only the string itself, but also two extra words. Remember, a word holds two 
characters. 

• The array information must be retrieved with the "Get_info" utility before calling this 
utility. 

• The offset of the element in the array must be correct in the array information (word 16 
returned by "Get_info"). It should be remembered that the offset of the element is 
dependent upon the number of dimensions in the array and the length of each. A calcula- 
tion may be necessary to arrive at the offset when accessing multiple-dimension arrays. 
The offset is in terms of number of elements. 
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Calling Procedure: 

1. Store the number of the starting byte of the substring desired into the first word of the 
storage area set aside for the substring. (Note that bytes and 1 are the length word of 
the string.) 

2. Store the number of bytes in the substring into the second word of the storage area. 

3. Store the offset within the array information. 

4. Load register A with the address of the storage area for the value. 

5. Load register B with the address of word of the information returned by the 
"Get_info" utility (see description of that utility). 

6. Call the utility. 

Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the call. The substring is returned starting with the third word of the storage area. 
(Note: since the second word contains the length of the substring, you have a string data 
structure starting with the second word!) 

For example — 



j+lii 



Jr?r:E 



..DR =c 
hH El 






•■=•-• Hi 



In this example, Value is the storage area. Since 2 has already been generated and stored in the 
first word, and 10 in the second, the first 10 bytes of the string element are transferred. Of 
course, the string element must contain at least 10 characters — or the bytes which are re- 
turned may be nonsense. 
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Changing the Value of an Argument 

At some point during the execution of your assembly language routine, you might want to 
accomplish the other half of this method of communication with BASIC — namely, changing 
the value of a BASIC variable which is used as an argument, in effect changing the value of a 
BASIC variable from the assembly language routine. 

As with retrieving a value, there are a number of utilities available for changing a value. The 
one to use is dependent upon the type of argument passed. The utilities available are — 





Name 


Used For 


Put_ 


value 


Simple variables and individual elements of 
arrays passed as arguments 


Put_ 


element 


Elements (from arrays passed as arguments) 


Put_ 


bytes 


Substrings of strings passed as arguments 

either as simple variables or as individual elements 

of arrays passed as arguments. 


Put_ 


elem bytes 


Substrings of elements (from string arrays 
passed as arguments) 



How each of these utilities is used is described in the immediately following pages. 

UTILITY: Putvalue 

General Procedure: The utility is given the address of the parameter declaration and the 
address of the value. It changes the value of the BASIC variable associated with the parameter. 
It works only on simple variables and individual elements of arrays (passed as arguments), of 
any type. 

Special Requirements: 

• The value must have the appropriate data structure for the data type of the argument (see 
"Data Structures" in Chapter 3). 

• An actual argument must have been passed by the ICALL for the utility to work properly. 
Calling Procedure: 

1. Load register A with the address of the storage area of the value. 

2. Load register B with the address of the parameter declaration. 

3. Call the utility. 
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Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the call. 

Here is an example call to the utility, passing information to an integer argument — 



UTILITY: Putelement 

General Procedure: This is similar to the "Put_value" utility. This utility changes the value 

of a single element in an array passed as an argument. It works on elements of arrays of any 

type. 

Special Requirements: 

• The value must have the appropriate data structure for the data type of the argument (see 
"Data Structures" in Chapter 3). 

• The array information must be retrieved with the "Get_info" utility before calling this 
utility. 

• The offset of the element in the array must be correct in the array information for the array 
(word 16 returned by "Get_info"). It should be remembered that the relative element 
number of the element is dependent upon the number of dimensions in the array and the 
length of each. A calculation may be necessary to arrive at the offset when accessing 
multiple-dimension arrays. 

Calling Procedure: 

1. Store the element offset into the array information (word 16). 

2. Load register A with the address of the storage area for the value. 

3. Load register B with the address of word of the information returned by the 
"Get_info" utility (see description of that utility). 

4. Call the utility. 
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Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the call. 

Here is an example call, storing information from Value into element of an integer array — 






"-. i i ! Or- 
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UTILITY: Putbytes 

General Procedure: This is similar to the "Put_value" utility. This utility changes the value 

of a substring which is part of a string variable or an individual element of a string array, having 

been given the starting byte and the number of bytes to be changed as well as the new 

characters. 



Special Requirements: 

• The bytes to be transferred are preceded by two words in the storage area. The two words 
contain the starting byte for the substring and the number of bytes to be transferred. 

• A string variable or an element of a string array must have been passed as an argument for 
the utility to work properly. 

Calling Procedure: 

1. Store the number of the starting byte of the substring to be changed into the first word of 
the storage area. (Note that bytes and 1 are the length word of the string) 

2. Store the number of bytes in the substring into the second word of the storage area. 

3. Load register A with the address of the storage area. 
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4. Load register B with the address of the parameter declaration. 

5. Call the utility. 

Exit Conditions: There are no error exits from the utility, so it always returns to the 
instruction following the call. 

For example — 



■z> U U K 
:~; I "i !...! R 



In this example, Value is the storage area containing the string to be transferred. Since 2 has 
already been generated and stored in the first word, and 10 in the second, the first 10 bytes of 
the string are changed. Why was the value 2 stored as the byte number? Because bytes in a 
string are numbered starting with 0, and bytes and 1 contain the length of the string (see 
"Data Structures" in Chapter 3). 

UTILITY: Putelembytes 

General Procedure: This is a combination of the "Put — element" and "Put — bytes" utilities. 
This utility changes a substring of an element in a string array which has been passed as an 
argument. The utility is given the starting byte and the number of bytes to be transferred. 

Special Requirements: 

• The bytes to be transferred are preceded by two words in the storage area. The two words 
contain the starting byte for the substring and the number of bytes to be transferred. 

• The array information for the array must be retrieved with the "Get_info" utility before 
calling this utility. 

• The offset of the element in the array must be correct in the array information for the array 
(word 16 returned by "Get_info"). It should be remembered that the offset of the 
element is dependent upon the number of dimensions in the array and the length of each. 
A calculation may be necessary to arrive at the offset when accessing multiple-dimension 
arrays. The offset is in terms of number of elements. 
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Calling Procedure: 

1. Store the number of the starting byte of the substring to be changed into the first word of 
the storage area. (Note that bytes and 1 are the length word of the string.) 

2. Store the number of bytes in the substring into the second word of the storage area. 

3. Store the element offset into the array information (word 16). 

4. Load register A with the address of the storage area for the string to be transferred. 

5. Load register B with the address of word of the information returned by the 
"Get_info" utility (see description of that utility). 

6. Call the utility. 

Exit Conditions: There are no error exits from the utility. It always returns to the instruction 
following the call. 

For example — 



In this example, Value is the storage area for the string to be transferred. Since 2 has already 
been generated and stored in the first word, and 10 in the second, the first 10 bytes of the string 
element are changed. It is the responsibility of the software (not shown) to assure that 10 
characters of valid data are stored in the remainder of the storage area. 
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Using Common 



Another way to pass information between BASIC and assembly language routines is through 
BASIC'S common area. 

You may recall from subprograms in BASIC that if you have a COM statement in the main 
program, the locations named therein can be accessed by other BASIC subprograms and 
functions through their own COM statements. Though the subprograms may change the 
names, the locations are the same. The order of appearance in a COM statement is all- 
important. If a main program has the statement — 



and a subprogram has the statement 



then X and A are the same storage location, B and Y are the same, and C and Z are the same. 

The same kind of operation is available in your assembly language routines with the COM 
pseudo-instruction — 



As with the SUB pseudo-instruction, the COM only serves as a preface. It is followed by one or 
more parameter declarations of the same types as in the SUB — 



The FIL is not permitted, since there is no corresponding item within BASIC'S COM syntax. 

Each pseudo-instruction used after an assembly language COM corresponds to an item in the 
COM declaration in the main BASIC program. Just as in a BASIC subprogram, the types must 
agree. ^ However, the ANY pseudo-instruction fulfills the same function here as it does with the 
SUB pseudo-instruction — to allow any type of item to be passed. 



1 If the types do not correspond, an error results (number 198). 
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As with SUB, arrays are designated by following the type with an array identifier — ( ) . If the 
type is ANY, the array identifier is not allowed. 

Each pseudo-instruction reserves three words of memory when assembled. And, like SUB, the 
words are used to contain a descriptor. The descriptors are used by the variable retrieval 
utilities for fetching and storing values in the common area. THE SAME UTILITIES USED IN 
FETCHING AND STORING ARGUMENT VALUES ARE USED FOR THE SAME PURPOSES 
FOR VALUES IN THE COMMON AREA. These utilities are — 

Get_info 

Get_value 

Get_element 

Get_bytes 

Get_elem_bytes 

Put_value 

Put_element 

Put_bytes 

Put_elem_bytcs 

The utilities are called in the same fashion and are subject to the same restrictions. See the 
description of the utilities in the preceding sections of this chapter to determine how they are 
used. 

The item pseudo-instructions used with the COM pseudo-instruction can have their own labels, 
just as the parameter declarations used with a SUB may have. And just as in a BASIC subprog- 
ram, they need not have the same names as were given the corresponding items in BASIC. For 
example, suppose the following BASIC common statement exists at the time of a call to an 
assembly language routine — 



then you could access Q(*) and Z$ by using these pseudo-instructions — 






Note the differences in names. 
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If the number of item pseudo-instructions in the assembly language routine exceeds the 
number of items in common at the time the routine is called, an error results (number 199). 

A COM pseudo-instruction sequence need only be set up once per module. Each routine within 
the module has access to the information within the sequence. The three-word descriptors are 
filled, and type-checking occurs, only once — at the first ICALL of a routine within the module. 

Busy Bits 

Overlapped processing in the 9835A/B is partially implemented through the facility of "busy 
bits". 

Each variable located in the BASIC value or common areas has associated with it two bits which 
are independent of the value — a "read" busy bit, and a "write" busy bit. Each time an I/O 
operation is executed that cannot be buffered, one of the busy bits is set. If a variable is having 
its value changed by the I/O operation, then the read busy bit is set. If the variable is output- 
ting its value in the I/O operation, then its write busy bit is set. If a variable is not involved in a 
pending I/O operation both bits are cleared. When the I/O operation is completed, the busy 
bits for the variables involved are cleared. 

When an I/O operation is encountered during execution of BASIC statements, the appropriate 
busy bits are set and a request is made by the operating system for the resources to satisfy the 
operation. Until that operation is complete, BASIC (in OVERLAP mode), continues to execute 
succeeding lines in the program until it encounters a statement which contains variables with 
busy bits that are set. 

If the statement is attempting to use the value of a variable and its read busy bit is set, then the 
further execution of the statement waits until the busy bit is cleared. The same is true for a 
statement attempting to change the value of a variable when either its read or write busy bit is 
set. When the I/O operation completes, the busy bits are cleared and the waiting statement is 
executed. 

In short, overlapped processing uses busy bits as a signal as to whether a statement can be 
executed or not. 



130 Communication Between BASIC and Assembly Language 



If an ICALL statement is executed with overlapped processing, it is possible that a BASIC 
variable in the common area may be "busy" when the routine wants to access it. (The busy bits 
of variables passed as arguments are checked — and are non-busy — before the ICALL is 
executed.) Although it is still possible to access the variable without regard to the status of the 
busy bits, frequently that is not a desirable programming approach. You may on occasion want 
to check the value of the busy bits when you suspect the user of the routine may be using 
overlapped processing. 

Busy bits are checked from an assembly program using the "Busy" utility to be described 
shortly. If you are checking the bits for a busy condition, and the busy condition is set, it 
remains set throughout the time you are in the assembly routine. For it to become un-busy, you 
must exit the routine and permit the operating system a chance to perform the I/O operation 
and clear the busy bits. 

For example — 



L'HLL, 

:f Bt 



If the Sort routine exits, setting Busy to if a busy condition is not encountered, and to 
non-zero otherwise, this is a tight loop which keeps trying to execute Sort until the common 
variables which are busy become un-busy and it can proceed on its way. By exiting the routine 
after each unsuccessful attempt, the operating system is given an opportunity to perform the 
I/O operation which has the variable(s) tied up. 

UTILITY: Busy 

The Busy utility checks the status of the busy bits of a variable in BASIC'S common area. It is 
not necessary to check the busy bits of a variable passed as an argument since all arguments are 
checked upon calling a routine (and the call is executed only when all the arguments are not 
busy). 

General Procedure: The utility is given the location of the common declaration for the vari- 
able. It returns the value Bf the busy bits for that variable into the A register. 

Special Requirements: This utility should only be used for variables in common. 
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Calling Procedure: 

1. Load register B with the address of the pseudo-instruction of the common declaration to 
be checked. 

2. Call the utility. 

Exit Conditions: The utility returns the busy bits in the A register. The "read" busy bit is in bit 
and the "write" busy bit is in bit 1. The other bits are not disturbed. 

In the following example, if any of the busy bits among three common variables is set, a flag is 
set and the routine is exitted — 



I SOURCE 








COM 






T SOURCE 


V':ir 


lab' 


e 1 :; 


INT 






I SOURCE 


•:'B.'r~ 


lab^ 


Slid " 


SHO 






loUURuL 


Var 


■iab^ 


E' -,'.;■■ " 


REL 






I SOURCE 








OUT: 






I SOURCE 


Bus 


'..' "'": ' 


ts: 


INT 






I SOURCE 


Sor 


t.T 




LIJB 


=Va.r 


iabl 


I SOURCE 








JSM 

C-Oi 


Busy 




I SOURCE 








LIiE 


=V.~ir 


iabl 


I SOURCE 








jsn 


Iiusy 




I SOURCE 








SRL 


2 
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L.DE 


=-'/ar 


■iabl 


ISOUFiJE 








SZR 


*+4 
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LDH 


==1 




I SOURCE 








LDB 


Busu 


_bit. 
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JSM 


PC4t.__ 
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Aor-k 


:; 
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i- ioro 


C E'S S. 
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Chapter / 

I/O Handling 



Summary: This chapter describes the various techniques of handling the receiving and 
sending of information to peripheral devices. Topics are: a review of I/O machine 
instructions, registers, applicable utilities, interrupts and interrupt service routines, 
handshake I/O, direct memory access, and mass storage devices. 

A major usage for assembly language programs is to improve or customize the performance of 
the 9835A/B with respect to data transfers with peripheral devices. The types of devices dealt 
with are those which communicate via the various interface cards (e.g., HP98032, HPIB, etc.). 
The types of I/O which the assembly language supports are programmed (handshake-type), 
interrupt, and direct memory access (or DMA). 

A number of detailed examples have been provided demonstrating the various types of I/O on 
different interfaces. These examples can be found in Appendix H. 

Peripheral-Processor Communication 

All I/O, except for that to the internal devices (tape cartridge, keyboard, printer, CRT or SLD), 
necessarily takes place through the "backplane". The backplane is that physical area of the 
machine where the interface cards are inserted (also known as the I/O "slots"). 



I/O Slots 




Figure 8. Location of I/O Slots (Backplane) 
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The backplane serves as an intermediary between the processor and the peripheral interfaces. 
The internal addressing of the backplane is transparent, both to the interfaces and to the 
programmer. 

Interfaces 

The processor does all its talking, through the backplane, to peripheral interfaces, never di- 
rectly to a peripheral itself. An interface is a complex electronic circuit which provides mechani- 
cal, electrical, data format, and timing compatibility between the 9835A/B and the peripheral 
device to which it is connected. From a programmer's point of view, the primary task of an 
interface is to provide a means of exchanging data between the 9835A/B and the peripheral. A 
well-designed interface isolates the programmer from the details of electronics and timing, 
appearing as a simple "black box" through which information is exchanged. 

The processor can talk to as many as 14 peripheral interfaces through the backplane. Each can 
be talked to individually, and there may be a mix of peripherals using programmed, interrupt, 
or DMA types of transfers. 

Individual I/O operations (i.e., exchanges of single words) occur between the processor and 
one interface at a time, although interrupt and DMA modes of operation can be programmed to 
allow automatic interleaving of individual operations. 

A peripheral is addressed through a select code and a transfer occurs through four special 
registers reserved for the purpose. These will each be discussed shortly. 

Discussion of the techniques and methods presented in this chapter uses the common HP 
interfaces as examples. A full discussion of the operation of these interfaces can be found in the 
Interfacing Concepts manual (HP part number 09825-90060) and also from your Sales and 
Service office (list in Appendix K). 

Example programs utilizing various I/O techniques with a number of the standard interfaces 
can be found in Appendix H. 

Registers 

All I/O operations go through a set of four registers maintained by the 9835A/B. The 
four — R4, R5, R6, and R7 — are the sole means of communicating data between the proces- 
sor and peripheral interfaces. While the registers are actually on the interface cards, they may 
be thought of as being in the computer memory. This makes the cards themselves accessible by 
simple memory referencing instructions. 
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The 9835A/B sees the registers as single- words and always sends or receives a full word of 
data when it references one of them. If a particular interface utilizes less than the full sixteen bits 
(when exchanging 8-bit extended ASCII data bytes, for example), then the most significant bits 
(8 through 15) are received as zeroes. On output, if fewer than 16 bits are utilized by the 
interface, it ignores the most significant bits. The value of these bits, in this case, is a "don't 
care" (i.e., may be any pattern of ones or zeroes). 

All of the HP 98030 series of interface cards use the registers as follows — 



Register 


On Input 


On Output 


R4 


Primary Data In 


Primary Data Out 


R5 


Primary Status In 


Primary Status Out 


R6 


Secondary Data In 


Secondary Data Out 


R7 


Secondary Status In 


Secondary Status Out 



The R4 register, then, is almost always used for data transfers. R5 is always used for status and 
control information. The "secondary" registers — R6 and R7 — perform the indicated 
functions only nominally. The exact interpretation as to how the register is used depends upon 
the interface card being used (see the Interfacing Concepts manual for details). 

In order to give some specific examples for using the registers, the 98032 16-Bit Parallel 
Interface (sometimes called General Purpose Input/Output — GPIO) is used. This card 
defines the secondary registers as — 



Register 


On Input 


On Output 


R6 
R7 


High-Byte Data In 
(unused) 


High-Byte Data Out 
Trigger 



Select Codes 

As mentioned earlier, more than one interface card may be connected to the 9835A/B. It 
becomes necessary, then, that there be a mechanism whereby a particular interface can be 
chosen to respond when an I/O register is referenced for either input or output. This 
mechanism is the Peripheral Address Register (Pa). 
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Pa holds a binary number in the range to 15 (utilizing only the lower four bits of the word, to 
3). Each interface has an externally-settable select code switch which can also be set to a value 
between and 15. However, since select codes and 15 are reserved for the internal printer 
and tape cartridge unit, respectively, the permissible select code settings are 1 through 14. 

Whenever an operation to one of the I/O registers is performed, the 9835A/B makes the 
contents of the Pa register available to all the interfaces connected to the backplane. Each card 
compares the value with its own select code. If they match, the interface responds to the 
operation. 

So, for example, if the following statements are executed in turn — 



3uUF:cE 


LDfl ■■ 


:5uURCE 


:3TH F 


SOURCE 


LDfi F 



I »ri 



then a word of data is read from the interface card set to select code 8. (The data was read in the 
third line; this is discussed in "Programmed I/O" below.) 

The label "Pa" is reserved by the assembler for the Peripheral Address register. 

Status and Control Registers 

The primary purpose of any interface is to allow data to be exchanged between the computer 
and the peripheral device to which it is connected. But HP's 98030 series of interface cards are 
even more versatile, possessing a programmable capability of their own. This in turn provides 
optional capabilities with the card that can be set and changed by control instructions from the 
9835A/B. (For details on what capabilities are provided, consult the Interfacing Concepts 
manual.) 

The programming of the interface is done by the 9835A/B using the R5 register. Some of the 
interfaces use other registers for extended control bits (these are also described in the Interfac- 
ing Concepts manual). 

Interface cards can also return information to the 9835A/B about which optional programming 
features are currently selected. This information, called the status byte, is obtained through an 
input operation using register R5. The status byte (8 bits) is determined solely by the charac- 
teristics of the interface card being addressed in the Pa register. Again, information on particu- 
lar cards can be found in Interfacing Concepts). 
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Remembering that these registers are not really memory locations, but instead are registers on 
the card being addressed by the Pa register, storing information to these locations is not the 
same as storing to other memory locations or registers. For example, storing a value in R5 to set 
the control register sends the information to the addressed interface. Later, if you were to read 
a value from R5, the information you sent would not be what is returned. Instead, the contents 
of the status register in the interface would be returned. 

Status and Flag Lines 

Whenever an I/O register is accessed, the interface with the same select code as is in the Pa 
register responds. The primary response depends upon the nature of the interface and which 
register is accessed (see discussion above). However, in all cases there is a secondary effect. 
Part of every interface's response is to set or clear the Status and Flag lines. 

The Status line (not to be confused with the status register discussed above), is a single bit 
indicating whether the interface is operational or not. By inclusion, this can also mean the 
status of the actual peripheral to which the interface is connected. For example, if a peripheral 
device has a line coming from it that indicates its power is on, it could be connected to the 
Status line in the interface. Then the program could quickly determine whether the device is 
turned on or off. As another example, a printer might have the Status line connected to the 
out-of-paper indicator (should it have one) to indicate to the program when it is inoperable 
because of lack of paper. 

The Flag line is a momentary "busy /ready" indicator used to keep the computer from getting 
ahead of the peripheral. The line shows that the interface is busy processing the last task given 
it by the 9835 A/ B or that it is ready for another operation. If the line is set, it indicates 
"ready"; if the line is cleared, it indicates "busy". For example, if the computer has a sequence 
of ASCII characters to send to a slow printer, it sends one character (making the Flag line 
"busy" ) and then waits for the Flag line to go "ready" again before sending the next character. 

There are four instructions, part of the I/O group, which can check these lines — 

Skip if Flag line is set (i.e., "ready") 

Skip if Flag line is cleared (i.e., "busy") 

Skip if Status is set (i.e., "operational") 

Skip if Status is cleared (i.e., "non-operational") 

These instructions have the capability of skipping up to 31 locations in a forward branch, up to 
32 locations in a backward branch, or to the same instruction. 
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Programmed I/O 



Programmed I/O is the process whereby software controls the transfer of information between 
memory and an interface. In the process the program must decide when and where to make the 
transfer, how to make it, and how much information to transfer. The decision even to originate 
the transfer comes under program control. 

The Status line can be used to determine the availability of an interface. The interface is 
selected, under program control, by the contents of the Pa register. Then the Status line is 
checked to see if the interface (and by inclusion its associated peripheral) is operational. 

After an operational interface has been chosen, the Flag line can be used to determine when 
the interface (i.e., peripheral) is ready for a transfer and when it has not finished with the 
previous transfer. 

With sufficient checks of Flag and Status before and between I/O operations, it is possible to 
eliminate initiating an I/O operation to an interface which isn't ready for it. For example, a 
simple output driver for the 98032 interface is — 



I SOURCE 
ISiOUF:CE 

.1 bUUKL-E. 



de 



i Ii-iforrri usei-- 

I Wa.it. unti 1 Last 

■ Output the ntxt 

! Start the hands! 



Interrupt I/O 



Interrupt I/O is a means of allowing control to pass temporarily to an assembly language 
routine other than the routine (BASIC or assembly language) currently executing. The 
"interrupt", which causes the control to be passed, is detected through the backplane and is 
associated with a particular interface. After the "interrupt service" routine completes its tasks, 
control is passed back to the original routine. 



The process looks something like this — 
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"original' 
routine 



interrupt . 
detected 




The sequence of events in interrupt I/O can be detailed as follows — 

1. The interface sends a request for service to the backplane which passes it along to the 
processsor. 

2. The processor alters the flow of execution so that the routine associated with that inter- 
rupting source can be executed. The processor saves its place in the interrupted routine 
so that it can later return to it. 

3. The interrupt service routine is executed, performing whatever functions are desired. 
Frequently these functions involve some form of programmed I/O or direct memory 
access. The service routine may signal an end-of-line BASIC branch, indicating to 
BASIC that some condition occurred (discussed below). 

4. The service routine returns the processor to the interrupted routine so that the "original" 
process can resume. 

The uses for interrupt I/O are so diverse that it is difficult to generalize about them. However, 
one particular use is fairly well-defined and of general applicability — data transfers. 

Interrupt I/O is normally used in data transfers whenever a particular data device has a transfer 
rate which is significantly slower than that of the computer. Since the 9835A/B has a transfer 
rate of around 10 000 characters per second, peripheral devices with transfer rates slower than 
this number are candidates for interrupt I/O. 



The usual approach is to transfer a word to or from the peripheral device, then go away to do 
some other processing white waiting for the device to interrupt by becoming "ready" for 
another transfer. 
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Priorities 

Select codes are assigned hardware "priority" levels to control what should be processed when 
an interrupt service routine is executing and another interrupt is received, or when two or more 
simultaneous interrupts are received. 

There are two priority levels — 

High for select codes 8 to 15 

Low for select codes to 7 

An interrupt received from a high-priority select code may interrupt a service routine which is 
executing for an interrupt from a low-priority select code. But an interrupt from a low-priority 
select code may not interrupt any other service routine. 

Interrupt Service Routines and Linkage 

An interrupt service routine is associated, or "linked", with a select code by the Isr_access 
utility described later. This linkage establishes where the interrupt service routine resides, and 
to which select code it applies. 

An interrupt service routine may be placed anywhere in the ICOM region. The routine typically 
does one or more of the following — 

• Talks to the interface (i.e., satisfies or acknowledges the interface's interrupt). 

• Passes data to (or retrieves data from) the rest of the program, when appropriate. 

• Breaks the linkage, if desired. 

The method of talking to the interface depends upon the type of interface. Some devices or 
applications do not require the passage of data; the acknowledgement of the interrupt is usually 
the desired effect in such cases. 

The linkage can be "broken" (or terminated) during an interrupt service routine by executing 
one of two statements. If the linked select code is high-priority, the statement is — 

JSM End isr high, I 
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If the linked select code is low-priority, the statement is — 

JSM End_isr_low,I 

The service routine is exited with a RET 1 instruction. 

Here is an example of a short interrupt service routine which simply reads a word of data from 
the interface — 



rpc 


^■- • 


SJf 


\ fe-rii! 1 i-iat. 6- ! 


mate;; JSv 




RET 





NOTE 

Utilities cannot be called from an interrupt service routine. 
Attempts to do so may lock up the machine. 

Access 

The operating system (OS) contains a mechanism to regulate requests for hardware capabilities 
in order to eliminate conflicting uses of these capabilities. For instance, since there is only one 
DMA channel, it is necessary that there be a mechanism to prohibit two simultaneous DMA 
transfers. 

The OS mechanism which regulates the use of DMA (and also interrupt) transfers either grants 
or does not grant what is called "access". Before starting either an interrupt or DMA operation, 
access should be requested from the operating system. 

Another example — suppose a device operating on a high priority select code has a relatively 
slow data rate. This is an ideal situation in which to use interrupt driven I/O. Suppose further 
that the device operates in such a fashion that the data must be transferred within a fixed time 
period following its issuance of an interrupt or the data is lost (the internal tape drive is such a 
device.) If there are other interrupt type transfers operating concurrently on other high priority 
select codes, it may not be possible to service our slow device within the necessary time frame. 
When the operating system grants access, this type of conflict is impossible. 



142 I/O Handling 



Users of the assembly language system are required to request access from the operating 
system. The OS grants access if granting this access does not compromise any previously 
granted access. 

Devices such as that discussed above which require interrupt service within a specified time 
frame are called "synchronous", and need "synchronous" access. Devices with no such time 
constraints are called "asynchronous", and need "asynchronous" access. 

The regulation of access incorporates the following points — 

• When the operating system grants synchronous access to an operation, it is guaranteeing 
that the requesting process will have its interrupts serviced with maximum priority. 

• DMA conflicts with synchronous access since DMA's cycle stealing causes the processor to 
run slower and could thus compromise a synchronous process. 

• Synchronous access on a low priority select code in conjunction with asynchronous access 
on a high priority select code is conflicting since the asynchronous device could interrupt 
the synchronous ISR, thus compromising the timing requirements of the synchronous 
device. 

• Synchronous and asynchronous access on the same priority level is also conflicting. 
Remember an interrupt request on the same priority level as a currently executing ISR will 
not be processed until the executing ISR completes. 

The following table summarizes the granting of access — 
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blank = Granted 
X = Not granted 
d = Dangerous, but granted 
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BASIC statements also obtain and release access as I/O is performed. The following table lists 
some of the ways access is used by the system: 



Use 


Access 


Cartridge Operations 


SYNC (HIGH select code) 


Flexible Disk Operations 


DMA 


PRINT, PRINT USING 


ASYNC 


Plotter Drivers 


ASYNC 


CARD ENABLE 


ASYNC 


ENTER/ OUTPUT INT 


ASYNC 


ENTER /OUTPUT DMA 


DMA 


ENTER/OUTPUT FHS^ 


DMA 



In general, single BASIC statements could cause access to be granted and released several 
times. For example, the cartridge operations obtain and release synchronous access once for 
each physical record transferred. 

UTILITY: Isr access 



This utility is used to request access and, if the access is granted, to create the linkage between 
an interrupt service routine (ISR) and a select code. Pressing RESET ( <£2o) (jioli ) during execu- 
tion of the utility may cause a SCRATCH A to be issued. 

General Procedure: The utility is told where the ISR resides and what kind of access is 
required. If access is granted, it returns successfully. If access is not granted immediately, it 
keeps trying periodically until it is successful or until a specified number of attempts have been 
made (in which case it returns unsuccessfully). 

Special Requirements: The B register must contain information as follows — 



Bits 



0-3 
4-5 
8-14 



Description 



Select code to be linked to the ISR 

Access code (see next page) 

Number of attempts to be made before aborting 



1 In addition to obtaining DMA access (which in thiscaseisuscd just to ensure there is no synchronous access granted), theFHS 
drivers disable all interrupts during the actual transfer loop. 
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The access codes are — 

Abortive access 

1 Asynchronous access with programmed I/O 

2 Asynchronous access with DMA 

3 Synchronous access with programmed I/O 

Calling Procedure: 

1. Load register A with the address of the ISR. 

2. Load register B with the information described above. 

3. Call the utility. 

Exit Conditions: 

RET 2 If the attempt at linkage is successful, the utility returns to the second word following 
its call. Register Pa is set to the select code; if access code 2 was specified then 
Dmapa has also been set to the select code. 

RET 1 If the attempt at linkage is unsuccessful, the utility returns to the first word following 
the call. Register A contains an indication of the type of difficulty encountered — 

- 1 Access couldn't be obtained after specified number of attempts. 

- 2 Select code is still linked to an assembly language ISR. 



Note: Access code (abortive access) should be used with caution. An interrupt routine with 
abortive access can exist on the same priority level as an interrupt routine with synchronous 
access. If the abortive routine is in progress when an interrupt occurs requiring the synchronous 
service routine, the abortive routine will finish before the synchronous routine can be serviced. 
The timing requirements of the synchronous routine might thus be violated. 

Access code is intended to be used by routines that will be executed only extremely 
infrequently. For instance, if the 9835A/B is monitoring a potentially dangerous 
manufacturing process, it may be necessary to have an interrupt service routine to shut down 
the process when something goes awry. This could be accomplished with an abortive routine. 
The advantage (and also the reason for the previously mentioned caution) of access code is 
that no other modes of access are prohibited by its use. Thus, the infrequently used routine will 
not prevent another routine from getting the type of access it needs. 
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As an example of the use of the Isr_access utility, suppose the ISR from page 141 is to be linked 
to select code 2 for asynchronous access. The following would be a sequence to establish such 
a linkage — 



JRCE 



State Preservation and Restoration 

When an interrupt is detected and an interrupt service routine is called, the processor automati- 
cally saves the state of some of the registers so that their values can be restored upon return 
from the ISR. Other registers are left alone and if your service routine uses them, it is up to your 
ISR to save them and restore them before returning from the ISR. 

The registers which are automatically preserved are — 



A 

B 

C 

Cb 

P 

Pa 



Also, the state of the Overflow and Extend processor flags are preserved and restored before 
the return from the interrupt. 
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If your ISR contains any of the following types of instructions — 

Indirect addressing 
Stack group 
CLR 
XFR 

and the operand of the instruction(s) is an address in the ICOM region, then it is necessary that 
the following instruction sequence be executed in the ISR before any such instruction is 
executed — 



STH S^aun; 
LDfl 34E 



Then, before the ISR exits, and after the affected instructions have been executed, the follow- 
ing sequence must be executed — 



Indirect Addressing in ISRs 

Indirect addressing in ISRs can produce anomalies unless the following rules are followed — 

1. If indirect addressing is employed with the operand being an address in the ICOM 
region, one of the processor registers must be preserved. For the method of doing this, 
consult the "State Preservation and Restoration" section immediately above. 
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2. If indirect addressing is used in a JMP or JSM (including any jumps to external symbols 
or symbols more than 512 words away from the current instruction, both of which have 
implied indirect addressing), then the most significant bit must be set in the address. For 
example, instead of — 



in an ISR the procedure must be — 



JSM (^sub+iseeeQE > , i 



Direct Memory Access 



lemory 
(DMA) 



Direct memory access (DMA) is a means to exchange entire blocks of data between memory 
and peripherals. A block is a series of consecutive memory locations. Once started, the process 
is automatic; it is done under processor control, regulated by the interface. Since only the 
98032A interface supports DMA, the following discussion is in terms of that interface. 

To the peripheral, the DMA operation appears as programmed I/O. The transfer, however, is 
actually performed by special DMA hardware. Information regarding the transfer is stored in 
the DMA registers for the DMA hardware to use. This information is the select code, the initial 
memory location, and the number of words to be transferred. The memory location register 
and the count register are successively adjusted after each word transferred until the transfer is 
complete. Upon completion of the transfer, the interface and the DMA hardware stop 
automatically. 
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The direction of the transfer is specified before the transfer takes place. It can be specified as 
either "inward" (i.e., from the peripheral to memory), or "outward" (i.e., from the memory to 
the peripheral). To set the direction outwards, the instruction — 



is used. To set the direction inwards, the instruction — 



is used. 

DMA Registers 

There are three registers which contain information used by the DMA hardware — Dmapa, 
Dmama, and Dmac. Before any DMA transfer takes place, the appropriate values must be 
loaded into these registers. 

Dmapa contains the peripheral address of the device requesting DMA. Only the least signific- 
ant bits of the register specify the select code which is to be the peripheral side of the DMA 
activity. During DMA transfers, the address bus takes its address from the Dmapa register rather 
than Pa as in other I/O transfers. The value is supplied to Dmapa by the Isr_access utility when 
it grants DMA access. 

Dmama contains the address of the first word in memory (i.e., lowest address) where the data 
transferred is (or will be) stored. After each word transferred, this register is automatically 
incremented. 

Dmac is the count register for a DMA transfer. Before the transfer begins, it should be set to 
n-1, where n is the number of words to be transferred. After each word transfer, the count is 
decremented. If, during a word transfer, the value of Dmac is (meaning that this is the last 
word to be transferred), the processor automatically informs the interface that the DMA 
operation will be complete after the present word is transferred. In the case of inputs where the 
amount of transferring data is unknown in advance, Dmac should be set to a very large number 
in order to disable the signal to the interface. 
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DMA Transfers 

DMA transfers are accomplished with six distinct actions. 

First, the Isr_access utility is used to obtain access to the D^4A channel and to set up the ISR 
linkage used when the transfer terminates. 

Second, the direction is set using an SDO or SDI instruction. If no direction is set, then any 
previous setting of the direction prevails. 

Third, the appropriate values are stored into the DMA registers. 

Fourth, the DMA requests are enabled using the instruction — 



Fifth, a "Start DMA" command is given to the interface using programmed I/O. With the 
98032 interface, this command is the value 3208 using the Primary Control register (R5-0ut). 

Finally, when the DMA transfer is complete, the interface generates an interrupt which causes 
the processor to branch to the designated ISR. This ISR should disable the card, and then 
disable the DMA mode with the instruction — 



The following is part of an ISR which demonstrates a typical set-up for a DMA inward transfer 
(in this case IK words placed into a buffer in memory) — 
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BASIC Branching on Interrupts 

The handling of interrupts can be integrated into BASIC programs by using the ON INT 
statements. The object is to allow the flexibility of combining the high-level features of BASIC 
with the capabilities of assembly language in asynchronous I/O applications. And since ISRs 
cannot use the system utilities, in particular those that access a BASIC variable, a means of 
taking action on an interrupt after completion of the ISR is a necessity. 

ON INT Statement 

The ON INT statement is an executable BASIC statement which acts in a similar fashion to the 
ON KEY statement (see the 9835A/B Operating and Programming Manual). The statement 
allows the BASIC programmer to specify where, in his BASIC program, to branch whenever an 
interrupt is signalled for the select code he specifies. 

As with the ON KEY statement, there are three ways these branches can be taken — 

{select code} [ , {priority} ] {subprogram name} 

{select code} [ . {priority} ] {line identifier} 

{select code} [ , {priority} ] {line identifier} 

Whenever an interrupt is signalled from an ISR for a particular select code, if ON INT has been 
executed for that select code, then at the end of execution of the BASIC line which was 
executing when the signal came, the indicated branch in the ON INT is taken. 

In the GOTO version, the branch is "absolute", which is to say that the program goes to the 
line indicated and picks up its execution there, forgetting where it was before. This has the 
effect of an "abortive" type of branch, and should only be used by the BASIC programmer 
when he wants the program to resume execution at some pre-determined point after handling 
an interrupt, without regard to where the program was before the interrupt occurred. 

In the CALL and GOSUB versions, the branch is only temporary. After the subprogram or 
subroutine has been executed and the SUBEXIT, SUBEND, or RETURN (as appropriate) has 
been executed, then the program returns to the line following the one where it was interrupted. 
This is the same as if the CALL or GOSUB was in between the interrupted line and the one 
following it. 

The {line identifier} and {subprogram name} in the CALL, GOSUB, and GOTO statements are 
the same as elsewhere in BASIC, except that a CALL may not have any parameters. 
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The {select code} specified in an ON INT statement restricts the branching action to occurring 
only when the assembly language triggers the ON INT condition for that select code. The 
interrupt may have occurred in actuality on another select code. This can be a way of allowing 
more than one branch for interrupts from a single interrupting device. 

As an example — 



sIjS^UE E.rid cJata. 



Should anywhere in the program an interrupt occur, causing an assembly language interrupt 
service routine to be executed, that assembly language ISR has the capability to cause either 
the branch of line 100 or the branch of line 110 to be taken. Thus, an assembly language ISR 
signals BASIC either to print an intermediate result or to note that all data has been processed. 

Signalling 

The {select code} specified in an ON INT statement restricts the branching action to occurring 
only when an interrupt is "signalled" for that select code. In actuality, an interrupt may not 
have occurred on that select code at all. Conversely, an interrupt may occur on the select code, 
but BASIC and its ON INT condition-may never hear about it. It is necessary for the ISR which 
does the actual handling of an interrupt to inform, or "signal", the operating system that the 
interrupt occurred and trigger the ON INT conditions which may be set up at the time. 

The responsibility of the ISR to signal the ON INT is also an opportunity. This signalling allows 
you in an ISR to decide whether or not you want BASIC to know about the interrupt. If you do 
not want BASIC to know, simply do not signal the condition. The signalling also allows you to 
signal different interrupt conditions. An example of doing this might be a case where, after an 
interrupt, a peripheral indicates whether it wants to input or output data. Your routine could 
signal one select code to execute ai? input routine and signal another select code to execute an 
output routine. 

To signal an ON INT, your ISR must execute the following instructions — 
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Mask necessarily contains the select code to be signalled. Rather than containing the number of 
the select code, however, it has the bit set for the appropriate select code. For example, if you 
are signalling select code 2, you set bit 2 to 1 in Mask and leave the others 0. Similarly, if you 
are signalling select code 5, you set bit 5. Thus, the statement containing Mask in the above 
could just as easily be a literal. For example — 



would signal select code 5. 

When you want to signal a select code after others have already been signalled, a slightly 
different instruction sequence is required — 



I SOURCE 


LDE 


Isr psw 


I SOURCE 


LDH 


= 10311 


I SOURCE 


STR 


E,I 


I SOURCE 


RDB 


=3 


I SOURCE 


LDfl 


ria-.k 


I SOURCE 


niR 




I SOURCE 


I OR 


E,I ! 


I SOURCE 


STH 


E,I 


I SOU ROE 


EIR 




I SOURCE 


STH 


Isr_flaq, 



! n 



in the 



:'CT. CUU 



Mask is the same as above. 



As a further example, suppose you want both to signal BASIC when a device sends a line-feed 
character to the computer, and to terminate the ISR's linkage. Then the ISR might appear as — 
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Additional Pre-Defined Symbols 

Isr_flag and Isr_psw are pre-defined symbols in the assembler. Also pre-defined are two other 
symbols used by the assembler — End_isr_low and End_isr_high. These symbols may not be 
redefined. 

Prioritizing ON INT Branches 

Since more than one interrupt may occur while a single BASIC statement is executing, it is 
possible that by the time the line finishes there may be a number of ON INT branches waiting to 
be executed. In such situations you may want to assure that some ON INT branches are taken 
before others, or that you finish one routine (caused by an ON INT GOSUB or ON INT CALL) 
before you start another. This can be achieved by using the {priority} option of the ON INT 
statement, thereby "prioritizing" the branching caused by interrupts.^ 

There is a "system priority" for ordering this interrupt branching. For an ON INT to be honored 
at the end of a BASIC line, its priority must be greater than the current system priority. 

Initially, the system priority is set to 0. When a BASIC line finishes, and there is at least one ON 
INT branch pending which is greater than the system priority, then the system takes the branch 
associated with the ON INT with the greatest {priority}. The values assigned to {priority} may be 
any integer numeric expression from 1 to 15. If {priority} is omitted,- 1 is assumed. 

If the ON INT branch to be executed is a GOTO, then the system priority level is unchanged. 
But if the branch to be executed is a GOSUB or a CALL, then the system priority level is 
changed to the priority level of the ON INT. Whenever the subroutine or subprogram is finished 
executing, then the previous system priority level is restored. 

Thus, with the GOSUB and CALL versions, there are two effects involving priorities — 

• The subroutine or subprogram is not allowed to execute until its priority is the highest one 
pending. 

• Whenever the subroutine or subprogram is executing, it locks out any other interrupting 
branches unless they have a higher priority. 



1 This "prioritizing" also holds between the various types of end-of-line branch statements that have the priority parameter. 
Thus an ON KEY with high priority is executed before an ON INT with low priority. 
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With the GOTO version there are also two effects, slightly differing — 

• The branch is not taken until it has the highest priority of all pending branches. 

• The execution of the branch does not lock out any other branches, so that at the end of 
the line to which it branches, if there are other pending branches, the highest one of those 
is executed. 

For example, suppose there are these four statements in effect — 



and also suppose that at the end of some BASIC line in the program, an interrupt had been 
received from all four of the interfaces involved. Then the process of dealing with them pro- 
ceeds like this — 



EVENT 


NEXT ACTION 


SYSTEM PRIORITY 


Reaches end of current 
BASIC line 


GOSUB Routine_7 


Changes from to 15 


Finishes Routine 7 


GOSUB Routine_5 


Changes from 15 to 9 



Suppose at this point another interrupt is received from select code 7. 



EVENT 


NEXT ACTION 


SYSTEM PRIORITY 


Reaches end of current 


GOSUB Routine 7 


Changes from 9 to 15 


BASIC line in Routine 5 






Finishes Routine 7 


Returns to interrupted 
point in Routine 5 


Changes from 15 to 9 


Finishes Routine 5 


GOTO 1000 


Changes from 9 to 


Finishes with line 1000 


GOTO Routine_4 


Stays at 
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Environmental Considerations 

Changes in program environment, i.e., calling a subprogram or returning from one, can affect 
whether an ON INT is in effect or not. 

Once executed, the CALL version of an ON INT is always in effect, whether in the main 
program or in any subprogram, until it is redefined by another ON INT or is specifically 
disabled (see below). 

In the GOSUB or GOTO versions, the statement is in effect only in the same program environ- 
ment. This is to say that if you have executed an ON INT statement in your main program, then 
it is effective only while your program is executing part of the main program. The instant the 
program goes into a subprogram (through a CALL statement), the statement is no longer 
effective until the execution returns to the main program. Similarly, if you define an ON INT in 
a subprogram, it is effective only while the program is executing that subprogram. 

A side-effect occurs here when you use the CALL version of an ON INT. By calling the 
subprogram with an ON INT, you have the effect of locking out the other interrupts, except 
those which are executed in the subprogram itself and other CALL versions. This is regardless 
of priority. In the priority example in the previous section, if the ON INT#5 had been a CALL 
instead of a GOSUB, then the second interrupt from select code, 7 would not have been 
acknowledged until the subprogram had finished. 

Since recursive calls of subprograms are possible, it is also possible that many calls to the same 
subprogram may be stacked up because an interrupt from a different select code with a CALL 
version of an ON INT in effect may be received while processing the CALL caused by a 
previous interrupt. 
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Disabling ON INT Branching 

The branching enabled by an ON INT statement can be disabled using an OFF INT statement 
for the same select code. It is effective for the ON INT statement within the same program 
environment (main program or subprogram) or for the CALL versions of the ON INT within any 
environment. 

The statement has the form — 

OFF INT # {select code} 

where {select code} is a numeric expression for any valid interface select code between 1 and 
14, inclusive. 

The effect of the OFF INT statement is to disable the ON INT for that select code within the 
current environment. If there is no ON INT statement currently in effect for the select code, 
then the OFF INT has no effect. 

The DISABLE and ENABLE statements work the same way for the ON INT statements as they 
do for the ON KEY statements. They should not be confused with the DIR and EIR machine 
instructions, which disable and enable the interrupt system. 



Mass Storage Activities 

For devices meeting the operating system's criteria for mass storage peripherals, the reading 
and writing of records is simple. 

If a device has been specified in a MASS STORAGE IS statement in BASIC, as in — 



or is capable of being so specified, then it is possible to use utilities to access it. 

There arc two utilities involved in reading from a mass storage device — Mm_read_start and 
Mm_read_xfer — and there are two utilities involved in writing to a mass storage device — 
Mm_write_start and Mm_write_test. The reading utilities are always used together. So, too, 
are the writing utilities. 
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Reading from Mass Storage 

The flow of data to and from a mass storage device is buffered. For each device there is a 
"device buffer" in memory which holds data corresponding to a physical record (256 bytes). 
Device buffers are dynamically allocated by the operating system and their actual locations at 
any given time are of no concern. 

To get information from a mass storage device into its device buffer takes the Mm_read_start 
utility. Then to get the information out of the buffer and into your user space takes the 
Mm read xfer utility. The transfer of data, therefore, looks something like this — 



Mass /_ 


^ [ 

Mm - read - start / 


Device 
Buffer 

/ 


/ Mm - read - xfer 


User 
Space 


Storage P 


/ 


/ 



The utilities accomplish their purposes with the help of two locations containing vital informa- 
tion for their use. The first is the Mass Storage Descriptor (MSD) and the second is the Mass 
Storage Transfer Identifier (MSTID). 

The MSD is three words in the ICOM region which contains the following information — 



WORD 



MSUS 


1 


lower 1 6 bits of 
record number 


2 


don't 
care 


upper 7 bits of 
record number 



15... 7 6 



This information must be provided by your program. You must determine this information in 
advance of attempting the reading operation. The msus is of the form — 



Unit 
Number 


HPIB 
Address 


Device 
Type"" 


Select 
Code 


1 1 1 
1 1 1 


1 1 
1 1 


1 1 1 1 
1 1 1 1 


1 1 1 
1 1 1 



15 14 13 12 11 10 9 8 7 



Bit 



1 The device type is the ASCII code for the type minus 1008. 
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The MSTID is a single word. The information in it is returned by the Mm_read_start utility and 
used by the Mm_read_xfer utility. 

The usual procedure in reading a record from mass storage (which is all that can be read at one 
time) is to call the Mm_read_start utility and then, if all goes well with that, to call the 
Mm_read_xfer utility. Because the latter utility may have to wait on the operating system or 
the device, it is possible the utility may return without having completed the transfer. In that 
case, it is your option either to loop back and keep trying, or to do something else and try again 
later. 

UTILITY: Mmreadstart 

General Procedure: The record number is determined, then the transfer of the record's 
contents is made from the device to the device buffer. If the buffer allocation causes a memory 
overflow, there is an error. 

Special Requirements: The record number and msus must be loaded into the MSD in ad- 
vance of the call. There must be a stable location (not changed by other activities) for the 
MSTID to be held. 

Calling Procedure: 

1. Store the msus and record number into the MSD area. 

2. Load register A with the address of the MSD area. 

3. Call the utility. 

Exit Conditions: 

RET 1 Occurs if there is a memory overflow during execution of the utility. 

RET 2 Occurs if all went normally. Register A contains the MSTID. This should be im- 
mediately stored in the location reserved for it. 
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UTILITY: Mmreadxfer 

General Procedure: The MSTID is used to retrieve the record from the device buffer. The 
record is stored into a location set aside for the purpose. 

Special Requirements: The MSTID must be available from a previous call to 
Mm_read_start. A location of 128 consecutive words must be set aside to hold the contents of 
the record when they are returned by the utility. 

Calling Procedure: 

1. Load register A with the contents of the MSTID. 

2. Load register B with the address of the storage location for the data. 

3. Call the utility. The transfer may not be completed on the first or subsequent calls (see 
exit conditions). In that case, to successfully complete the transfer, all three steps must 
be repeated. 

Exit Conditions: 

RET 1 Occurs when the transfer is not completed. It is up to your routine at this point to 
decide whether another attempt should be made immediately, or whether some- 
thing else should be executed (and to come back later). 

RET 2 Occurs when the transfer is complete. The location specified contains the data. If 
register A contains a non-zero value, an error occurred and A is the error number. In 
addition to mass storage errors (80 through 99), error 19 is returned if the MSTID 
parameter is invalid. 



CAUTION 

Pressing RESET ( E^mGI^) during execution of either of the 
above utiities may cause a SCRATCH A to occur. 



160 I/O Handling 



The following is an example of a typical call to these utilities to read a record from mass 
storage — 



Writing to Mass Storage 

Writing to mass storage is very much like reading from it. The flow of data is buffered. To get 
the data from the user space into the device buffer, and then to transfer the data from the buffer 
to the mass storage device, the Mm_write_start utility is used. Then a test can be made to 
determine when the transfer is complete by using the Mm write test utility. 



As with the reading utilities, these utilities accomplish their purposes with the help of the same 
two locations — MSD and MSTID. They contain the same information as they do in the reading 
utilities and are used in a similar fashion. 
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UTILITY: Mmwritestart 

General Procedure: The record number is determined, then the transfer of the data is made 
from the ICOM region to the device buffer. If the buffer allocation causes a memory overflow, 
there is an error. 

Special Requirements: The record number and msus must be loaded into the MSD in ad- 
vance of the call. There must be a stable location (not changed by other activities) for the 
MSTID to be held. The data to be transferred must be ready (256 bytes — 128 consecutive 
words). 

Calling Procedure: 

1. Store the data to be transferred in its location. Store the msus and record number into 
the MSD area. 

2. Load register A with the address of the MSD area. 

3. Load register B with the address of the data location. 

4. Call the utility. 

Exit Conditions: 

RET 1 Occurs if there is a memory overflow during execution of the utility. 

RET 2 Occurs if all went normally. Register A contains the MSTID. This should be im- 
mediately stored in the location reserved for it. 

UTILITY: Mmwritetest 

General Procedure: The MSTID is used to check to see if the data from the buffer has been 
transferred to the mass storage device. 

Special Requirements: The MSTID must be available from a previous call to 
Mm write start. 
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Calling Procedure: 

1. Load register A with the contents of the MSTID. 

2. Call the utility. The transfer may not be completed on the first or subsequent calls (see 
exit conditions). In that case, to successfully test for a completed transfer, both steps in 
the calling procedure must be repeated. 

Exit Conditions: 

RET 1 Occurs when the transfer from the device buffer to the device is not completed. It is 
up to your routine at this point to decide whether another test should be made 
immediately, or whether something else should be executed (and to come back 
later). 

RET 2 Occurs when the transfer is complete. If register A contains a non-zero value, an 
error occurred and A is the error number. In addition to mass storage errors (80 
through 99), error 19 is returned if the MSTID parameter is invalid. 



CAUTION 

Pressing RESET ( g^mci^) during execution of either of the 
above utilities may cause a SCRATCH A to occur. 



The following is an example of a typical call to these utilities to write a record to mass storage 
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System File Information 

As an ASSIGN statement is executed in BASIC, a file-descriptor is created for that assignment 

in the operating system's files table. The ASSIGN statement essentially has two parameters — 

the file number and the file name (including the BASIC language mass storage unit specifier). 

The file number is, for all practical purposes, an offset into the files table. The file name and the 
BASIC language mass storage unit specifier are translated and the critical information as- 
sociated with them comprise an entry in the files table (i.e., the "file descriptor"). 

The file descriptor consists of 10 words containing the following information — 



Word 


Description 





Lower 16 bits of the address of the first physical record in the file 


1 


Number of logical records in the file 


2 


Current physical record number (i.e., an offset from the file's beginning. 


3 


Current word in physical record 


4 


Size of a logical record (in words) 


5 


Mass storage unit specifier (msus) 


6 


Buffer address 


7 


Check read status (0 = off, 1 = on) 


8 


Highest 7 bits of the first physical record in the file 


9 


(Reserved by the operating system) 



Note that words 0,5 and 7 contain the information necessary to create an MSD. You may 
access a file descriptor through two utilities — Get_fiIe_info to obtain the information, and 
Put_file_info to change the information. 



NOTE 

A files table is created for each BASIC "environment" (i.e., 
main program and subprograms). When access is made 
through utilities to the files table, the table accessed is the 
one associated with the BASIC environment which called the 
assembly language program. 
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UTILITY: Getfilcinfo 

General Procedure: The utility is given the file number and the location of a place to store the 
file descriptor. It retrieves the designated descriptor and stores it, provided the file has been 
assigned. 

Special Requirements: There must be a ten-word area available for the utility to store the 
information from the descriptor. 

Call Procedure: 

1. Load register A with the address of the ten- word area where you desire the information 
to be stored. 

2. Load register B with the file number (an integer from 1 to 10). 

3. Call the utility. 

Exit Conditions: 

RET 1 Occurs if the file has not been assigned by a BASIC ASSIGN statement. 

RET 2 Occurs if all went normally. 

Here is an example of a routine which has a file number passed to it, and then gets the file 
descriptor — 
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UTILITY: Putfileinfo 

General Procedure: The utility is given the file number and the location of the area contain- 
ing the new file descriptor information. It stores that information into the files table as indicated 
by the file number, provided that the file has been assigned. 

Special Requirements: The new pointer information must be stored in the designated area 
before calling the utility. This information must be in the correct form and location or file 
difficulties may ensue. Most of the information is normally returned by the "Get_file_info" 
utility and only a couple of words are changed to change the pointer in the file (e.g., the current 
record and word numbers). Only words 2, 3, and 7 should be changed in the descriptor. 

Calling Procedure: 

1. Load register A with the address of the ten-word area where the information is stored. 

2. Load register B with the file number (an integer from 1 to 10). 

3. Call the utility. 

Exit Conditions: 

RET 1 Occurs if the file has not been assigned by a BASIC ASSIGN statement. 
RET 2 Occurs if all went normally. 
Here is an example where the next physical record in a file is specified — 
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Printing 



Two utilities are provided to enable you to gain access to the standard system printer — 
Printer_select and Print_string. 

Printer_select enables you to set the standard system printer to a select code of your choosing. 
Print_string enables you to print a string to the standard printer. 

Utility: Printer_select 

General Procedure: The utility is given the select code to be assigned as the standard system 
printer and the desired printing width. The utility makes the assignment and returns with the 
previous values of both the select code and printer width. 

Special Requirements: The select code value must be in the range of through 17 for the 
utility to work properly. Neither the previous nor the selcted printer should be on HPIB device. 

Calling Procedure: 

1. Load register A with the desired select code. 

2. Load register B with the desied printer width. 

3. Call the utility. 

Exit Conditions: There are no error exits from the utility, so it always returns to the instruc- 
tion following the call. Register A contains the value of the previous select, and register B 
contains the value of the previous printer width. 

The utility can feasibly be used just to interrogate the current value of the printer's select code. 
However, a second call to the utility is needed in such cases to assure that the select is not 
changed by the first call. So, for example — 



This results in an unchanged printer specification and the values for the select code and width 
being stored in the ICOM area for future use. 
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Because of the possibility that a RESET ( |£2eID QioQ ), or similar interruption, may occur between 
the first and second calls to the utility, it is recommended that the first call have a definite valid 
value for the select code in A (as above). In that way, should there indeed be an interruption, a 
valid select code for the printer can be assured. 

Utility: Print_string 

General Procedure: The utility is given the address of a string, and it prints that string to the 
standard system printer. 

Special Requirements: The string to be printed must be in standard string format (see "Data 
Structures" in Chapter 3). The string must be no longer than 506 characters. 

Calling Procedure: 

1. Load register A with the address of the string to be printed. 

2. Call the utility. 

Exit Conditions: 

RET 1 If a memory overflow occurs during execution of the utility. 
RET 2 If the lsiolJ key is pressed during execution of the utility. 
RET 3 If all goes normally. 
For example — 



CAUTION 

Pressing RESET (E^lDCHsD) during execution of the 
Print_ string utility may cause a SCRATCH A to occur. 
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Chapter O 

Debugging 



Summary: This chapter describes techniques for isolating and correcting logic prob- 
lems in assembly programs. Included in the discussion are techniques for stepping 
through programs, getting dumps, patching, and using the keyboard. 

The assembly system has provided you with a number of BASIC language tools to help you 
debug your assembly language programs during their development stages. 

These tools are for run-time debugging, so your source code must have been assembled into 
object code and stored in the ICOM region before attempting to use any of the debugging 
features detailed in this chapter. 

There are three classed into which these tools fall: stepping through programs, dumps, and 
value checking. There is also an additional capability provided for the correction of some 
errors — patching. 

The BASIC statements available for debugging are — 



and the following BASIC functions are available — 
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Stepping Through Programs 

"Logic" difficulties are some of the hardest problems to solve in debugging programs. In batch 
environments, the usual solution is to print the contents of variables at critical points in the 
program or to print dumps. The capabilities for both of these methods are provided. However, 
advantage has been taken of the interactive, "hands-on" nature of the 9835A/B and a feature 
has been added which allows you to execute the assembly statements individually. This permits 
you to examine the flow of the program as it executes rather than having to decipher a dump or 
trying to print the contents of specific variables at what you guess is the critical point. 

If you are desirous of looking only at particular points in the program, or at particular variables, 
there is also the ability to establish "break points" for these items, so that your debugging 
routines can be invoked only when certain conditions arise. You can also establish different 
routines for different break points, adding to the flexibility. 

Individual Instruction Execution 

Normally, all BASIC lines, including the ICALL statement, act as a unit. That is to say, 
whenever you press the (j^ key, the line which is currently executing is allowed to finish 
before the program is actually interrupted. Thus, if you press (^ during execution of the 
line — 



100 LE: i H-l +1 

the line finishes and the variable A contains the value 2. Then the (^ takes effect. The same is 
true of a line containing an ICALL statement. 

For example, if you press (|^ during the execution of — 



then the assembly routine completes before the (^ is honored. This is not always desirable; 
especially not during debugging of the assembly routine. It does not allow you to look at the 
execution of the routine to help you determine what may be going wrong. 

The same problem occurs with the i-2i££J key. Pressing UiiD causes an entire BASIC line to be 
executed. Thus, if you stepped through line 120 as above, the entire routine Sort would be 
executed, and you would not be able to observe its execution on an instruction-by-instruction 
basis. 
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To permit you to analyze the execution of assembly language routines, an executable BASIC 
statement has been provided — 



Now, should you have the sequence in your program 



then pressing (^^ during the execution of line 120 would cause program execution to be 
interrupted after completion of whatever machine instruction is being executed at the time. 
Further, the assembly language source line associated with the following instruction is dis- 
played according to certain rules. 

If the source lines are still in memory when you press (^^ (e.g., you just assembled the object 
code which you are running), then the source line is displayed. If the source is no longer in 
memory (e.g., the object code was obtained through an ILOAD), then the instruction displayed 
is the result of a "reverse assembly". If there is an operand with an instruction which is reverse 
assembled, then the octal value of that operand is displayed (this is because the reverse 
assembly process has no way of knowing what symbols you might have used to assemble the 
instruction originally). 

After pressing (^^, should you press (^^, execution resumes normally. It is not necessary for 
you to do anything (such as cleaning up the registers, etc. ) for execution to resume as if you had 
never interrupted it. 

After pressing (^ , you may want to observe the flow of execution of your assembly routine. 
This can be done by successively pressing the i^i££J key. Each time the key is pressed, another 
machine instruction is executed and the assembly source line associated with the next machine 
instruction is displayed. You may continue this way for as long as you like — until you press 
[^°ntJ to allow processing to proceed uninterrupted until the end of the routine. 

Of course, the CHID key can be used to step through the BASIC program as you are used to 
doing. That feature is unchanged. It is possible, therefore, to "step into" the assembly lan- 
guage routine from the BASIC (i.e., you need only fHIQ into line 120 above) and not have to 
use the Q key at all. 
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In summary, IPAUSE ON allows two unique features — 

• The (^^ key can be used to halt execution within an assembled routine. 

• The ui£LJ key can be used to execute individual assembly language instructions. 

Some key things to remember in using the IPAUSE ON facility — 

• This is an execution-time debugging tool. You must be executing your previously- 
assembled object code with an ICALL statement. 

• If the source code is available for display, it will be displayed, otherwise the line is 
"reverse assembled". 

• Utilities are not stepped instruction-by-instruction, but rather as a unit. 

• The LsistJ key performs in BASIC just as before. 

• Keeping the CHID key depressed causes repeated execution of the stepping function, the 
same as in BASIC. 

By way of example, suppose you had the following source code — 



I'Oi 



Bin mziei 














icon 100 














IFFIUSE OH 














IHSSEMELE Extract 














Loop: LIWPUT m 














FfllJSE 














IChLL Extract <H±> 














PRIHT "<"imy'>" 














GOTO LciOp 














I SOURCE 


r^HM 


Extract 




i Ext 
'' :=t r 


"acts 


part of i 
"•ecedinq ' 


I SOURCE 


eS 


Get_uait 


■ie 


Put 


.■•a ! 14 e 




I SOURCE 


SUE 












I SOURCE Parameter 


;; STR 












I SOURCE Extract: 


LDH 


=String 




1 


Rt't r 


ieMe St r il- 


I SOURCE 


LDE 


=:Parame-- 










I SOURCE 


J:3M 


Get__ua1i 


4e 








I SOURCE 


i...DE 


String 






I n i t 


ia! i ze coi. 


I SOURCE 


LDH 


^Strinq 




i 


I nit 


i a 1 i ze st ■■= 


I SOURCE 


ShL 


i 










I SOURCE 


HER 


Strinq 










I SOURCE 


HDH 


= 1 










I SOURCE 


STfl 


c 














" E-ni r '■:± L. !.■ r:: f ' 
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Then the following would be the display lines you would see as you executed this program 
using the LsiiLi key — 



10 niM h$l10] 
20 icon 100 

30 IP RUSE OH 

40 IRSSEMELE Extn 

!=^0 Lnnn: LINPnT R$ 



160 0M0b0 002025 I SOURCE 

180 00062 142025 I SOURCE 

190 00063 00?i-'56 ISOURCE 

210 00065 lr'0600 ISOURCE 

220 00066 023753 ISOURCE 

240 00070 030016 ISOURCE 

250 00071 070530 ISOURCE 

260 0007'2 074760 ISOURCE 

290 00075 054001 ISOURCE 

300 00076 067774 ISOURCE 

260 00072 074760 ISOURCE 

270 00073 012016 ISOURCE 

290 00075 054001 ISOURCE 

300 00076 067774 ISOURCE 

260 00072 074760 ISOURCE 

270 00073 012016 ISOURCE 

290 00075 054001 ISOURCE 

300 00076 067774 ISOURCE 

260 00072 074760 ISOURCE L..r 

270 00073 012016 ISOURCE 

290 00075 054001 ISOURCE 

300 00076 067774 ISOURCE 

260 00072 074760 ISOURCE U. 

270 00073 012016 ISOURCE 

280 00074 066004 ISOURCE 

320 00100 026012 ISOURCE Yt 

330 00101 037740 ISOURCE 

340 00102 002003 ISOURCE 

350 00103 006003 ISOURCE 

360 00104 166007 ISOURCE 

80 PRINT "<"iiH$;">" 
< 12345 > 

■30 GOTO Lcof:, 
50 Loop: L INPUT m 






-fl ~54E 



IMP 


Loor 


i 


^■iBC 
JPR 


H 

=54] 


1 


IMP 


Yes 




RIJE 


=-1 




5TE 


Str- 


ng 

■inq 

ame 


JMP 


Put 


v^'l 



\ is i t. -B. COiUfihB.': 
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Note that the address of the instruction, as well as the octal value of the instruction, is displayed 
along with the source line. 

This stepping facility can also be used, quite effectively, with the IBREAK statement (discussed 
below). 

Should the IPAUSE ON facility be no longer desired, it can be turned off with — 



The two statements can appear repeatedly in a program, allowing the stepping facility to be 
used in testing some programs but skipping over already proven programs. For example, 
suppose you had two programs — Sorta and Sortn — but the first was already tested and the 
second was not. Then this sequence might appear in your program — 



■'RUSE' OFF 
:hl..L Sorta <fl$ 
•'fliJSE W 



Stepping through this sequence results in lines 110, 120, and 130 executing without interrup- 
tion, but line 140's call to Sortn would be executed instruction-by-instruction. 

Executing IPAUSE ON when the facility is already in effect causes no change. Similarly, execut- 
ing IPAUSE OFF when the facility is already off causes no change. 

Both IPAUSE ON and IPAUSE OFF can be executed from the keyboard. 

Setting Break Points 

It is possible to define points in an assembly language routine where the execution should 
pause should it ever reach that point. These are called "break points". They can be used to 
pause execution — allowing you to utilize the stepping activity described above in IPAUSE ON 
or to investigate the contents of variables, etc. They can also be used to allow branching to 
some BASIC routine, giving you the power of BASIC in doing some of your debugging. 

Simple Pausing 

To simply pause at a break point, you need to execute the following statement in advance of 
reaching that point (either in the program or from the keyboard) — 

1 13 R: L F-i i-( {address} 
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where {address} is the assembled location^ for the break point desired. Following execution of 
this statement, anytime the program execution reaches this address, it pauses. You may do any 
keyboard operations necessary at this point, or you may start stepping the program, (if 
IPAUSE ON has been executed), or you may resume execution using the [^°^ key. The 
address must have been assembled before the IBREAK is executed. 

If you were to execute — 



then every time the fourth word past assembly label "Hook" is reached during execution, the 
program execution pauses. If you were to execute — 



then Hook is assumed to be a BASIC variable, and the result of the expression is assumed to be 
an absolute address using whatever the value of Hook is when the statement is executed. 

You can also specify the number of occurrences of reaching a break point before pausing 
should come into effect. This is done by executing — 

I EH'? EFiK {address} ;; {counter} 

where {counter} is a numeric expression; any variables within {counter} are BASIC variables. A 
pause occurs when {address} has been reached {counter} number of times, {counter} is reset 
after each pause. 

When a break point is reached and a pause is to be taken, the pause takes place before 
execution of the contents of that address. 

Transfers 

Instead of just pausing at a break point, it is possible to branch to a BASIC routine. The intent of 
this facility is to give you access to BASIC'S capabilities, particularly the printing and variable- 
testing facilities, during your debugging efforts. 



1 See "Buzzwords" in Chapter 1 for the definition of "assembled location". 
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The branch can be any of the three standard forms of BASIC branching — 

I BREFlK {address} [; {counter} ] CFiLL {subprogram} 

< {address} [; {counter} ] GOSUB {line identifier} 

< {address} [; {counter} ] GOTO {line identifier} 

When either CALL or GOSUB has been designated, execution of the assembly language 
routine is suspended when {address} is reached. Then the designated subprogram or sub- 
routine is executed. When that subprogram or subroutine is completed, then execution of the 
assembly language routine resumes with {address}. 

When GOTO is specified, an unconditional branch is taken when {address} is encountered and 
execution of the assembly language routine is terminated. 

{counter} performs the same as in the simple pausing form. 

In the GOSUB and GOTO forms, there is an "environmental" restriction. The {line identifier} 
must be in the same BASIC environment (i.e., main program or subprogram) as that in which 
the IBREAK statement is executed. More on this in "Environments" below. 

Environments 

The GOSUB and GOTO types of break points are related to the BASIC "environment" (i.e., 
main program or subprogram) in which they are executed. Whenever an IBREAK statement of 
either type is encountered, the resulting break point is effective only for the environment in 
which the statement is located. The CALL version of break points is in effect in all environ- 
ments. 

For example — 



the break point established for "Hook" is good only in the subprogram "Test". Leaving Test 
causes the break point to be cleared. 
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Executing an IBREAK statement from the keyboard is effective only for the environment 
executing at the time the statement is made. For example, if the following program lines had 
been executed — 



and while the pause caused by line 210 is still in effect — 



is executed, then the break point established for "Hook" is good only in the subprogram 
"Test". As with the above, leaving Test causes the break point to be cleared. 

If no program is executing when an IBREAK is executed from the keyboard, then the main 
program is considered to be the environment for the break point. If the program is replaced, as 
with a GET or a LOAD, then the break point is cleared. 

Data Locations 

Break points can also be established for data locations. This is done with — 

1 13 P. 11 Fi R T 1-1 {address} 

In this case, {address} is presumed to be a data location referenced by other instructions. 
Whenever it is referenced by execution of some instruction, the pause occurs. 

If you were to say — 



then whenever "Renras" is referenced, such as in — 



a pause would occur for that instruction. 
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A counter can also be specified with this form of break point — 

{address} ; {counter} 

{counter} is of the same form, and operates in an identical fashion, to the counter of the 
non-DATA form of break point. 

Because the XFR machine instruction may access a particular location twice when it is exe- 
cuted, the break point on a data location may not operate correctly if the instruction referencing 
it is an XFR. The way to avoid this incorrect operation of the break point is to set {counter} to 2. 
(The only time this problem occurs is when the destination area for the XFR overlaps the 
origination area.) 

Symmetry suggests that you should also be able to branch to BASIC routines with the DATA 
form of break point just as you can with the non-DATA form. And so you can — 

{address} [ ; {counter} ] {subprogram} 

{address} [ ; {counter} ] . {line identifier} 

{address} [ ; {counter} ] {line identifier} 

They operate in an identical fashion to transfers of the non-DATA type and are under the same 
"environmental" restrictions. 

In order to determine whether an address is being referenced, each instruction is "interpreted" 
(that is, analyzed for its components). Resultantly, a program runs much slower while an 
IBREAK DATA statement is in effect. 

In addition to the pausing capability, using IBREAK DATA also allows trapping on "protected 
memory" violations (see "Protected Memory" section of this chapter). 

IBREAK Everywhere 

You may have a total of eight (8) break points (regardless of type) in effect at a given time, 
except for one extreme case. It may be desirable to establish a break point at every location in 
the ICOM region. This can be accomplished with — 
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This statement overrides all other IBREAK statements and causes a pause before execution of 
every instruction in the ICOM region. There are also branching forms — 

] - - {subprogram} 

{line identifier} 
. {line identifier} 

Note, however, that there is no {counter} in any of these forms. 

Number of Break Points 

As was mentioned above, there can be no more than eight (8) IBREAK statements in effect at 
one time, that is to say within the same environment. And only one IBREAK ALL can be in 
effect at a given time. 

In addition, there can only be one IBREAK or IBREAK DATA each in effect for a given 
{address}. Executing an IBREAK or IBREAK DATA with the same {address} as specified in an 
already effective IBREAK or IBREAK DATA statement causes the newly-executed statement to 
override the previous one. While there may be an IBREAK and IBREAK DATA both for the 
same {address}, the capability is not a useful one. 

Clearing Break Points 

There are a number of ways that break points can be cleared. One way as has already been 
mentioned, is leaving the BASIC environment, which clears any GOSUB or GOTO type of 
break points. Another way is to reassemble the module containing the break points. A third way 
is to execute an INORMAL statement. This statement has the form — 

{address} 



After execution of the statement, whatever form of break point is established for the address 
(except IBREAK ALL) is cleared. 

If {address} is omitted in this statement — 



then all break points are cleared. This is the only way to clear an IBREAK ALL which may be in 
effect. ^ 
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Protected Memory 

An assembly language program is allowed to access only certain portions of memory during the 
process of stepping with the lsi^eJ key or when an IBREAK DATA statement is in effect. Should 
you try to step through a program which makes an access outside of the allowed memory, then 
an error results (number 187). The same is true if an IBREAK DATA statement is in effect. 
"Access" means jumping to or writing into memory. 

The allowed memory is — 

• The ICOM region. 

• BASIC'S "value" area (the region where BASIC variables are stored). 

• BASIC'S common area (the region where BASIC common variables are stored). 

• The processor registers 

• The temporary values stored in the base page (pre-defined symbol "Base_page"). 

• The utilities. 

All other memory is considered "protected" memory. 
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Dumps 



A common tool of debugging is the memory "dump". This is a print-out (or display) of the 
contents of selected locations in the memory. A typical use is to dump areas of the ICOM 
containing data so that the actual contents at some point during execution can be compared 
with the expected contents. All of this is in the hope that the comparison yields differences 
which give a clue as to the source of the difficulties being encountered. 

This tool is provided through the IDUMP statement which has the form — 

I DUMP {location} [ ; {location} [ ; ...] ] 

This statement can be placed in a program to be executed (perhaps as the result of a branching 
IBREAK statement) or it can be executed from the keyboard (perhaps during a pause caused by 
stepping or IBREAK). 

Any number of {location}s can be specified. They can take a number of forms. The simplest 
is — 

{address} 

Thus, IDUMP {address} prints the contents of {address} to the current system printer. The 
contents are printed in their octal representation. 

{location} can specify a whole range of addresses by using the form — 

{address} TO {address} 

With this form, the IDUMP statement prints the contents of sAl addresses starting with the first 
and ending the last specified {address}. If the second address is numerically smaller than the 
first, then a "wrap-around" through the end of memory into the top of memory is taken. For 
example, if you execute — 



then the contents of four addresses would be printed — those for 177776, 177777, 0, and 1, in 
that order. Again, the contents are printed in their octal (base-8) representation. 
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Addresses are always specified in their octal representation, or symbolically (such as "Hook" 
or "Loop"). This is the same as for an assembled location, which is what {address} happens to 
be. 

The output of the IDUMP statement is always printed to the current system printer. It is in octal 
form, unless otherwise specified. This specification is accomplished by preceding {address} 
with {mode selection}, which is one of the following — 

flSC for ASCII character representation 
I N for binary representation (base-2) 
DEC for decimal representation (base-10) 
HE- ■ for hexadecimal representation {base-16) 
OCT for octal representation (base-8) 

Thus, the general form of {location} is — 

[ {mode selection} ] {address} [TO {address} ] 

As an example of all this, take the example program at the beginning of the chapter. If a couple 
of statements are added so that the main BASIC program reads — 



10 


DIM fi$[10] 


20 


I COM 100 


30 


IHSSEMELE Extract 


40 


I BREAK Loop GOSUE nurnp 


50 


IDUMP 41 TO 104 ! Dump of IC 


60 


PRINT 


70 


„oop: L. INPUT m 


80 


ICRLL Extract ^fl*> 


90 


PRINT "<"i;h$? ^'>" 


100 


GOTO Loop 


110 


1 


120 


! Durffp HjE registers in octal forr 


130 


1 string length in decin-ial forrn, a 


140 


! and the string in character forf! 


150 


i 


160 


Dump: IDUMP H TO B|DEC String; fiSC 


170 


PRINT 






i, 1 TC 
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then running it results in the following print-out — 



000053: 021335 000001 100207' 000000 000205 002025 

000065: 170600 023'P53 022021 030016 070538 141714 012016 

000077: 170201 026012 037748 002003 006003 166007 

000000 : 000 1 1 5 00001 2 

00004 K +00010 

000000;; 000071 000011 

000042 : 1 2345 , 673y$5"; 

000000: 000870 000010 

000041: +00010 

y k} y w 4 ;:::! : 1 i::! ;.::' 4 ^d , t- :'' t; ';' * b ;■■;; 

000000: QQ0id66 000006 



il 



Value Checking 



Value checking is a method of tracing the value of variables in your assembly language program 
using the interactive capabilities of the 9835A/B. You already have been introduced to break 
points and dumps in earlier sections. The capability of value checking serves as a useful adjunct 
to these procedures. 

The value checking of assembly "variables" is similar to the monitoring of variables in BASIC 
during a debugging phase. Just as you would use a live-keyboard operation or judiciously 
placed PRINT statements to trace the execution of a program or the change in value of a 
variable in a BASIC program, so too can you use the monitoring tools for assembly programs. 
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Functions 

Four additional functions are provided as extensions to BASIC which can be useful in the 
monitoring of values in an assembly language program. The four are — 

nc-pjivlpl 



n 



They can be used as other than monitoring tools, but their descriptions here are primarily in 
that context. As functions, these items can be easily adapted for use in the special function 
keys. 

DECIMAL 

This function has the form — 

DECIMAL ( {octal value} ) 

The function converts an octal integer value into its decimal representation. If the argument 
given is not octal, then an error (number 184) results. 

This can be used as a quick, simple way of converting octal numbers into the more familiar 
decimal value. Being a function, it can be used anywhere any other BASIC numeric function 
can be used. Often you will find it useful in PRINT statements which are a part of subroutines 
called by break points. 

OCTAL 

This function is the converse of the DECIMAL function. Its role is to convert decimal values into 
their octal (base-8) representation. The function has the form — 






{decimal value} 



This can be used as a quick, convenient method of converting decimal numbers into their 
frequently used octal representations (a form which is useful because of its ready conversion 
into binary representation, and vice-versa). 

The values resulting from this function must be treated with care. Though the result of the 
function is an octal representation, the value is still base-10. This difference is unimportant 
unless you are going to do arithmetic with the value resulting from the function. 
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As an example of this, suppose the decimal value 15 is to be converted into octal. The method 
is — 



and the resultant value is 17, the octal representation of 15. Now, if the result has 1 added to it, 
as with the expression — 



the ultimate result is 18. This can be a surprise since the usual octal arithmetic suggests that the 
result of 178 + 1 be 208. To get the proper octal result, the procedure is — 



Note also that the expression — 



still does not yield 20. 

lADR 

This function yields the numeric value in octal representation of an assembled location. The 
form is — 



{assembled location} 



As an example, take the case of the example program at the beginning of this chapter. The 
result of — 



is 76. 



This function can be viewed as a convenient method of determining the address of a symbol, or 
of an offset from a symbol. 
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IMEM 

This function is a quick, convenient way to look at the contents of a specific location in 
memory. The result is a numeric value, in octal representation, for the contents of a specified 
address. The form is — 

( {assembled location} ) 

The function is similar in many respects to the IDUMP statement. It is easiest, perhaps, to list 
the differences — 

• IMEM is a function, where IDUMP is a statement. 

• IMEM deals only with a single address, where IDUMP can deal with many. 

• IMEM represents the value only in octal, where IDUMP can use many different representa- 
tions. 

• IMEM can be displayed and stored, where IDUMP can only be printed. 

An obvious use for the function is in a routine called by an IBREAK statement. By using the 
function in such a manner, perhaps in a PRINT statement, you can ease the burden of checking 
variables from the keyboard. You can even use the value returned as a comparison against 
some set of limits so that you print only when the value exceeds those limits. There are many 
other possibilities for use. 



Interrogating Registers and Flags 

Interrogating the processor register A, B, P, R, Pa, Cb, Db, Dmapa, Dmama, Dmac, C, D, Ar2, 
SE, and Arl yields meaningful results only when execution of an assembly language subprog- 
ram has been suspended due to detection of a break point, or due to the use of the Lsuli or (^ 
keys (see Stepping Through Programs). 

Further, the values of cetain processor flags are stored in specific memory locations when a 
subprogram is suspended as described above. The flags are then available for interrogation as 
follows: 

Decimal Carry least significant bit of location SOs 
Overflow least significant bit of location Sis 

Extend most significant bit of location Sis 
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It is important to note that interrogating an I/O register (R4, R5, R6, or R7) causes an input 
I/O bus cycle, using the current Pa register contents as the interface address. See Chapter 7 for 
details on the effects of such an action. 



Patching 

Patching is the practice of changing the contents of memory locations without re-assembling. 

Patching as a standard procedure does not come highly recommended in the programming 
world. Nonetheless, there are circumstances which arise that occasionally suggest patching as 
the most profitable course of action. 

To change a particular location in memory in the 9835A/B is not difficult. The statement to use 
is — 

E {assembled location} TO {octal expression} 



After execution of the statement, the specified {assembled location} contains the specified octal 
value. 

Changing the contents of a register is a common use of this facility. However, it should be 
remembered that attempting to change the contents of the I/O registers {R4, R5, R6, or R7) 
causes an output I/O bus cycle to occur, using the Pa register for the interface address. See 
Chapter 7 for details on the effects of such an action. 



188 Debugging 



Chapter 9 
Table of Contents 



Errors and Error Processing 

Types of Errors ........................................................... 189 

Syntax-Time and Assembly-Time Errors, ................................. 189 

Run-Time Errors .................................................... 190 

Utility: Error_exit. , 191 

Run-Time Messages ............................................................ 193 

Assembly-Time Messages 195 



189 



Chapter 9 

Errors and 
Error Processing 



Summary: This chapter contains a discussion of Assembly Language ROM and other 
related errors, and what causes them. Included are methods for trapping errors and 
possible methods for correcting them. 

Whether you are writing or accessing an assembly language routine, it is possible to encounter 
an error resulting from your actions. The intent of this chapter is to give some guidance as to 
how certain errors can be handled. It is not intended as a definitive checklist of what can go 
wrong, nor is it an exhaustive treatment of the means to correct the difficulties which are listed. 
Rather, it is meant as a reference for some of the things which can go wrong, what might cause 
them, and how to deal with them. Each programmer has a unique method of approaching the 
problem of error processing and there is no way to anticipate all of them. Even so, the following 
should offer some assistance in identifying the source of an error. 

Not every machine error is covered here — only those directly related to writing or accessing 
assembly language routines. A complete listing of error messages (though not in the same detail 
as in this chapter) can be found in Appendix J. 



Types of Errors 



There are three types of errors associated with assembly language routines: those which 
occur during the writing (or entering) of the source code (called "syntax-time" errors); those 
which occur while assembling the source code (called "assembly-time" errors); and those 
which occur during the execution of an assembly language routine (called "run-time" errors). 
Some of these errors can be anticipated and trapped, others cannot. 

Syntax-Time and Assembly-Time Errors 

Syntax errors are caught when entering source code, usually with the message — 
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The error can then be immediately corrected and the statement reentered. A side-effect of this 
entry-time check of the syntax is that the time required for assembly is greatly shortened over 
what it would be if syntax-checking were deferred until assembly. 

Errors encountered during the assembly process are indicated by the assembler in three ways: 

• The message — 

nn 

is displayed, nn is the line number of the lASSEMBLE statement. This is a fatal BASIC 
error, unless otherwise trapped. 

• Each line in the source code containing an assembly error is printed on the current system 
printer. Included is the message — 



followed by the error type. 
• The message — 



follows the listing of the individual errors. The total number of errors is also printed. 
An explanation of the individual assembly-time errors can be found at the end of this chapter. 

Run-Time Errors 

Run-time errors can sometimes be anticipated. They come at two distinct times, and your error 
processing is different depending upon which of those times are of concern. The times are 
"program development" and "production run". 

During program development, errors normally are handled using the debugging techniques 
detailed in Chapter 8. Care should be taken in recognizing errors during development. Not all 
of them are obvious or indicated by an error message — many simply lock up the machine. 
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During the running of production (debugged) routines, errors can be caused by the users of the 
routines. For instance, the user may inadvertently assign an argument a value of zero when that 
argument is to be used as a divisor within the assembly language routine. You should try to 
anticipate these usage errors and program procedures to trap them. 

There are many alternatives for actions to take when your routine encounters and traps a usage 
error. For example, you may wish to assign a value to a particular return variable, or you may 
want to print a warning message, or, perhaps, to correct the value and proceed with the 
routine. Another method is to notify the user by issuing a BASIC error message. Such messages 
can be issued through the Error_exit utility discussed below. 

Of course, you need to tell the users (in the documentation of the routine) what kind of errors 
can occur, when they can occur, and what to do about them. 

UTILITY: Errorexit 

The Error_exit utility provides you with the capability of aborting an assembly language 
routine by "creating" a BASIC error. Two types of BASIC errors can be created — 
"recoverable", which can be trapped by a BASIC ON ERROR statement; and "non- 
recoverable" (or "fatal"), which cannot be trapped. 

General Procedure: The utility is given the number of the error to be created. Then the utility 
is called with the JSM instruction, but no return is made to the original assembly language 
routine from the utility. Instead, the utility uses the information placed on the return stack to 
help create the error. The return stack is appropriately "cleaned up" and control is returned 
either to the BASIC driver (if the error is non-fatal) or to the operating system (if the error is 
fatal). 

Special Requirements: Error numbers are passed to the utility in the A register. The value of 
the error number is placed in bits 0-14. Bit 15 is set if the error is to be non-recoverable. If bit 
15 is not set, the error will be recoverable. Error numbers 32 762 through 32 767, with bit 15 
set, are reserved by the operating system and should not be used. 

Calling Procedure: 

1. Load the error number into the A register. 

2. Call the utility using the JSM instruction. 
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Exit Conditions: The utility returns control to the BASIC driver which called the routine, 
appropriately setting conditions so that ERRL, ERRM$, and ERRN work as expected. Also 
triggers ON ERROR, if applicable. 

The utility can be used anywhere in your assembly language, wherever you would like to abort 
the execution of the current assembly language routine and where you would like to indicate to 
BASIC what reason (error) caused the abortion. 

For example, suppose somewhere in one of your assembly routines you wanted to abort the 
routine if a certain variable (Flag) is non-zero at a certain point. Suppose also that the variable, 
when non-zero, contained the error number, then your program could look like — 



I SOURCE LDH F'lag 



Similarly, there are some utilities which, when an error is encountered, return an error number 
in register A. In these case, a quick two-instruction sequence can give you an error-related 
abort. For example, the Rel math utility is such a utility — 






As an example of a fatal error, suppose the error desired is 8. The error sequence could be 



OUK:CE LDR -IwyQiidE 
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Run-Time Messages 



The following is a list of the system error messages you, or the users of your routines, may 
receive should something go wrong retrieving, using, or storing assembly language routines. A 
possible corrective action, or actions, is included in the discussion of the error. 



ROM missing, or configuration error. To operate the 9835A/B, all system 
ROMs must be in place. In addition, to write assembly programs, the Assembly 
Execution and the Assembly Development ROMs must also be installed. Per- 
form the system test if the problem persists. 

Memory overflow. You may have specified an ICOM which is too large for 
your current available space. Some things to try: select a smaller ICOM size; 
execute SCRATCH C (if no important data remain in common), delete mod- 
ules and reduce the ICOM size; segment your BASIC prorams; segment your 
assembly programs. The error may also be caused by trying to load modules 
which are too large for the current ICOM region (either collectively or 
individually). 

Improper argument in DECIMAL or OCTAL function. The OCTAL function 
has a range from - 65535 to + 65535. The DECIMAL function has a range 
for its arguments of — 1777778 to + 1777778. 

Break Table overflow. A maximum of eight breaks can be established with the 
IBREAK statements and be in effect at one time. If eight breaks are in effect, 
then to allow other breaks to be established it is necessary to clear previous 
breaks using the INORMAL statement. 

Undefined BASIC label or subprogram name used in IBREAK statement. 
When the IBREAK statement is executed, an undefined label or name is al- 
lowed, but when the break actually occurs, the label or name must exist. 

Attempt to write into protected memory; or, an attempt to execute an 
instruction not in the ICOM region. This is the result of an attempt to branch 
outside of permissible areas or to change the contents of memory outside of 
the permissible areas. There is probably a difficulty in the logic of the program 
which needs to be corrected. This error only occurs when the ^^^ key is being 
used, an IBREAK DATA statement is in effect, or when using the ICHANGE 
function. 
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Label used in an assembled location not found. Symbolic addressing requires 
that all assembly symbols be resolved by execution time. This error probably 
results from a misspelling of a label or forgetting to assemble the module 
containing the label. 

Doubly-defined entry point or routine. A module being assembled (with an 
lASSEMBLE statement) or loaded from mass storage (with an ILOAD state- 
ment) contains a SUB or ENT entry point with the same label as a SUB or ENT 
entry point within a module already resident within the ICOM region. Check 
the other routines for the duplicate occurrences. 

Missing ICOM statement. You must include an ICOM statement to create your 
ICOM region before assembling or loading modules. Program an ICOM state- 
ment of adequate size and re-run the program 

Module not found. The module indicated in an ISTORE or lASSEMBLE 
statement is not currently resident in the ICOM region. Check the module 
names used in your ISTORE statement to find the one which is missing from 
memory. 

Errors in assembly. At least one error was encountered while assembling one 
of the modules in your lASSEMBLE statement. 

Attempt to move or delete module containing an active interrupt service 
routine. This is the result of trying to reduce the size of the ICOM region (or to 
eliminate it), or trying to delete a module, when one of the affected modules 
contains an active interrupt service routine (ISR). The only ways to allow the 
action to take place are to SCRATCH A (which affects a number of other 
things) or to inactivate the ISR. To inactivate the ISR, consult the routine's 
documentation, or press Reset ( E^lDGIoQ). 

IDUMP specification too large. The resulting dump would be more than 
32 768 elements. 

Routine specified in ICALL not found. You are specifying the wrong routine 
name or you are failing to load the correct module. Double check the 
documentation indicating the location and name of the routine. 

Unsatisfied externals. Symbolic addressing requires that all references to sym- 
bols outside the current module be resolved at the time any routine within the 
current module is executed. This may possibly be a missing ENT instruction 
within another module. 
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Missing COM statennent. The routine you are calling is expecting to find or 
place some of its data in common, but you are not providing the COM state- 
ment required. Add the appropriate COM statement in the BASIC program 
and re-run it. 

BASIC'S common area does not correspond to assembly module 
requirements. The routine you have called is expecting to find or place some 
of its data in common, but your COM statement does not match up with the 
assembly COM declarations in either type or size. Check both the COM 
statement in the BASIC program and the COM declarations in the assembly 
routine. 

Insufficient number of BASIC COM items. The routine you are calling is ex- 
pecting to find or place some of its data in common, but your BASIC COM 
statement does not provide enough variables to satisfy the routine's needs. 
Check both the COM statement in the BASIC program and the COM declara- 
tions in the assembly routine. 



Assembly-Time Messages 



The following is a list of the assembler error messages you may receive while assembling a 
module. All of these errors cause a "fatal" error, which means that the assembly produced no 
object code. After the error has been corrected, it is necessary to re-assemble the module 
containing the error. A possible corrective action, or actions, is included in the discussion of the 
error. 



Doubly-defined label. A label can only be defined once in a module. In addi- 
tion, any label used in an EXT instruction is restricted from being used again as 
a label in the module. Check all spellings; change a label name to something 
else, if necessary. 

END statement missing; or module name does not match. The END statement 
(in an ISOURCE statement) must be included to signify the end of a module. 
The name in the END statement must match the name used in the immediately 
preceding NAM statement. Particular ones to look out for: assembling more 
than one module at a time, but leaving out the END instruction between 
modules; or, the END instruction is after the BASIC program's END statement. 
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Expression evaluation error. This is a result of a mismatch of element types in 
the operand of an instruction. The particular prohibited forms 
are: relocatable -I- relocatable; external ± external; using the relocatable or 
external forms with the * or / operators. Check the spelling and type of your 
symbols in the expression. 

Literal pools full or out of range. You may have exhausted the storage given in 
your literal pool (LIT) declarations. In this case you should add more LIT 
declarations or increase the size of the ones you have. Another cause of the 
error can be using a literal in an instruction and there is no literal pool within 
512 words of the instruction. Additionally, for some instructions, the assem- 
bler attempts to create an indirect reference automatically and requires a lit- 
eral pool within 512 words of the instruction. In either case, add another literal 
pool (using a LIT instruction) within range. 

ICOM region memory overflow. The current module being assembled has 
caused object code generation which exceeds the current memory allowance 
for the ICOM region. Either you must re-run the current main BASIC 
program with a new ICOM statement increasing the ICOM size, or you must 
rearrange your assembly so that the module fits. This latter course can include 
deleting other modules or rewriting the abortive module so that it requires less 
memory. 

Operand out of range. Some instructions using indirection require a 
relocatable expression to evaluate to an address within 512 words of the 
current address. Skips must be no more than 32 words in either direction. The 
EXE instruction requires a register (0 to 31) and the instructions in the Stack 
Group require registers in the range of to 7. Check to see that the operand 
used is within the range appropriate for the instruction. Also, check the 
spelling on all symbols to see that the right symbol was used. 

Parameter declaration pseudo-instruction out of sequence. The ANY, FIL, 
INT, REL, SHO, and STR pseudo-instructions must follow a SUB or COM 
pseudo-instruction, or be a part of a group of such pseudo-instructions which 
follow a SUB or COM pseudo-instruction. Any other appearance of these can 
cause this error. It can also be caused if a SUB sequence does not terminate 
with a machine instruction with a label. Check to see that you have not 
inadvertently omitted the SUB or COM, or have placed another instruction in 
between the pseudo-instruction and its SUB or COM. 
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Incorrect type of operand used. Each instruction requires that its operand be 
of a certain type — relocatable or absolute. Check the type of aU symbols used 
in the expression in the operand and see that they correspond to the type 
required by the instruction. If you are u^ng a constant, check to see that a 
constant is edlowed by the instruction. 

Undefined symbol. By the end of the assembly, all symbols must have been 
defined, either by use as a label on an instruction or as a symbol associated 
with a value through an EQU, EXT, or SET pseudo-instruction. A symbol not 
so defined, except those pre-defined by the assembler, and used in the assem- 
bly, causes this error. Check the spelling of all undefined symbols to make sure 
that you did not intend something else. The symbol otherwise has to be de- 
fined, either by label or EQU, EXT, or SET. 
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Appendix /\ 

ASCII Character Set 



The following table and chart show the ASCII character set and the keypresses necessary to 
obtain the ASCII character codes. 
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ASCII Character Set 



ASCII 
Character 


Comments 


Key(s) 
to Press* 


Octal 
Code 


Decimal 
Code 


NUL 


Null 


(coNT l) space bar 


00 





SOH 


Start of Header 


(coNT L| Q 


01 


1 


STX 


Start of Text 


(CONTLlQ 


02 


2 


ETX 


End of Text 


ICONT L| fc^ 


03 


3 


EOT 


End of Transmission 


(CONTL|(^ 


04 


4 


ENQ 


Enquiry- 


(CONTLlfi^ 


05 


5 


ACK 


Acknowledgement 


ICONT L| Q 


06 


6 


BEL 


Bell 


ICONT L| fo") 


07 


7 


BS 


Backspace 


(CONT L) Q 


10 


8 


HT 


Horizontal Tab 


(CONT Li rn 


11 


9 


LF 


Line Feed 


(CONTLirT) 


12 


10 


VT 


Vertical Tab 


lCONTL)Q 


13 


11 


FF 


Form Feed 


(CONTL|(T^ 


14 


12 


OR 


Carriage Return 


Icontl) mJ 


15 


13 


SO 


Shift Out 


ICONT L) Q 


16 


14 


SI 


Shift In 


(CONTL|f O 


17 


15 


DLE 


Data Link Escape 


ICONT L| (^ 


20 


16 


DCl 


Device Control 


(CONTLlfoj 


21 


17 


DC2 


Device Control 


(CONT L| Q 


22 


18 


DC3 


Device Control 


(CONT L) Q 


23 


19 


DC4 


Device Control 


(CONT L| fr] 


24 


20 


NAK 


Negative Acknowledgement 


(CONTLlQ 


25 


21 


SYN 


Synchronous Idle 


ICONT Ll rVl 


26 


22 


ETB 


End of Text Block 


(CONTL|(^ 


27 


23 


CAN 


Cancel 


(CONT L| ^ 


30 


24 


EM 


End of Media 


(CONT L| Q 


31 


25 


SUB 


Substitute 


(CONTLjQ 


32 


26 


ESC 


Escape 


(CONT Li rn 


33 


27 


FS 


File Separator 


(CONT L| G\ Q~j 


34 


28 


GS 


Group Separator 


(CONT L| rT) 


35 


29 


RS 


Record Separator 


(CONTLlf/^J 


36 


30 


US 


Unit Separator 


(CONT U IsHIFtI J * 


37 


31 



* Assumes CAPS mode; multiple keys must be pressed simultaneously. 
Also can be found among calculator keys. 
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ASCII Character Set (continued) 



ASCII 




Key(s) 


Octal 


Decimal 


Character 


Comments 


to Press « 


Code 


Code 


SP 


Blank 


space bar 


40 


32 


! 


Exclamation Point 


(-)0 


41 


33 


" 


Double Quote 


H© 


42 


34 


# 


Pound Sig-n 


B© 


43 


35 


$ 


Dollar Sign 


S® 


44 


36 


% 


Percent Sign 


B© 


45 


37 


& 


Ampersand 


R© 


46 


38 


' 


Apostrophe 


© 


47 


39 


( 


Left Parenthesis 


© 


50 


40 


) 


Right Parenthesis 


© 


51 


41 


* 


Asterisk 


(•"")©• 


52 


42 


+ 


Plus Sign 


©©* 


53 


43 


> 


Comma 


©• 


54 


44 


- 


Minus Sign (Dash) 


B* 


55 


45 




Period 


©* 


56 


46 


/ 


Forward Slash 


©* 


57 


47 





■ 




©* 


60 


48 


1 






©* 


61 


49 


2 






©• 


62 


50 


3 






{%)' 


63 


51 


4 






©• 


64 


52 






Numerics 






5 






©* 


65 


53 


6 






©* 


66 


54 


7 




. 


©• 


67 


55 


8 






©• 


70 


56 


9 


• 




©• 


71 


57 




Colon 


H© 


72 


58 


; 


Semicolon 


© 


73 


59 


< 


Less Than 


R© 


74 


60 


= 


Equal 


©• 


75 


61 


> 


Greater Than 


B© 


76 


62 


? 


Question Mark 


©© 


77 


63 



* Assumes CAPS mode; multiple keys must be pressed simultaneously. 
Also can be found among calculator keys. 
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ASCII Character Set (continued) 



ASCII 




Key(s) 


OctAl 


Decimal 


Character 


Comments 


to Press 1^ 


Code 


Code 


@ 


Commercial At 


0Cf) 


100 


64 


A 






® 


101 


65 


B 






(iJ 


102 


66 


C 






(c) 


103 


67 


D 






® 


104 


68 


E 






C^ 


105 


69 


F 






© 


106 


70 


G 






(^ 


107 


71 


H 






(^ 


110 


72 


I 






O 


111 


73 


J 






CiJ 


112 


74 


K 






c^ 


113 


75 


L 






CiJ 


114 


76 


M 




Capital 


(m) 


115 


77 


N 




Letters 


(Nj 


116 


78 


O 






(^ 


117 


79 


P 






© 


120 


80 


Q 






® 


121 


81 


R 






© 


122 


82 


S 






© 


123 


83 


T 









124 


84 


U 






© 


125 


85 


V 






© 


126 


86 


W 






® 


127 


87 


X 






© 


130 


88 


Y 






w 


131 


89 


Z 


- 




© 


132 


90 


[ 


Left Bracket 


©CD 


133 


91 


\ 


Reverse Slash 


Inaccessible 
from Keyboard 


134 


92 


] 


Right Bracket 


©(^) 


135 


93 


t 


Up Arrow 





136 


94 


— 


Underscore 


HO 


137 


95 



* Assumes CAPS mode; multiple keys must be pressed simultaneously. 
Also can be found among calculator keys. 
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ASCII Charactei 


' Set (continued) 






ASCII 




Key(s) 


Octal 


Decimial 


Character 


Comments 


to Press T!f 


Code 


Code 


t 


Grave Mark 


Inaccessible 
from Keyboard 


140 


96 


a 






fc)® 


141 


97 


b 






t)® 


142 


98 


c 






y(cj 


143 


99 


d 






H® 


144 


100 


e 






H")® 


145 


101 


f 






H® 


146 


102 


g 






8® 


147 


103 


h 






R® 


150 


104 


i 






R® 


151 


105 


J 






R® 


152 


106 


k 






R® 


153 


107 


1 
m 




. Noncapital 
Letters 


R® 

[shift] Q 


154 
155 


108 
109 


n 






Q® 


156 


110 


o 






R® 


.157 


111 


P 






R® 


160 


112 


q 






H® 


161 


113 


r 






R® 


162 


114 


s 






(shift) (Sj 


163 


115 


t 






R® 


164 


116 


u 






H® 


165 


117 


V 






shift] [v ) 


166 


118 


w 






Q(w) 


167 


119 


X 






R® 


170 


120 


y 






R® 


171 


121 


z 






(shift) [z] 


172 


122 


{ 


Left Brace 






173 


123 


1 


Vertical Line 






174 


124 


} 


Right Brace 




Inaccessible 
' from Keyboard 


175 


125 


'\j 


Tilde 






176 


126 


DEL 


Delete 






177 


127 



* Assumes CAPS mode; multiple keys must be pressed simultaneously. 



ASCII Character Codes 



ASCII 




/«:EPf;i=«>RMS 


S*cjt; 


.•*Sgri: 


Char. 


■ISf 


;H«f,T'': 


;;cfia»;; 


NULL 


^^:fMiO(^^K 


■W>^::^' 


smim 


;^"spa«e:; 


SOH 


;;ISQO0qoi;;J 


:;Wl':'- 


sA:;::- 


;;::i; ;;;;■: 


,..;;.;:,:(.;:,;;;: 


STX 


:;iI«0()C)OiP!fl 


Sosj 


:<-;;02':;!;i- 


:;-2;= 


;;.^.>S:;i;i:.i 


ETx:. 


;.'(iiifMjlii::;; 


■■^■op3|=i 


'Mm 


'MS 


i'Mi 


EOT 


I'OpHiM' 


"Wi'i 


yW!'i 


;:r:|:; ■:;;:: 


■\'y0^' 


ENQ 


■•■^iSiffil 


':-^S$ 


IM:':'i 


Bit 


■f^^R 


ACK 


V;OPOP<),110.';: 


'■■OO&ri:.' 


::'0;% 


"^■p": 


^ ■;.;.;&;';:,; 


BELL 


sPoowil:!':;: 


'■mi 


■:•■;■: ;07;';:''- 


-?:"■''■ 


';:■:;;■- ;;;;■! 


BS 


:;'tK)ob:itiO-J, 


::0i¥' 


f'Wiy. 


;8-.; 


';:;'1:;'::: 


HT 


:fldooiooi:= 


■■oii'i' 


'109-'' 


;;*;:=•■■;; 


':'<)-:■■: 


LF 


POOOlOlt?: 


;012:.::' 


OA 


;iO''; 


■■ ...*. :, 


VT 


obooioii:: 


013 : 


(B 


.■11;.; 


:':^.;4;::.^; 


FF 


oooonoo 


014;: 


OC 


12 


■";':;, 


CR 


oooonoi 


015 


OD 


13 


- 


SO 


00001110 


016 


OE 


14 




SI 


00001111 


017 


OF 


15 


,;,/■.■■ 


DLE 


00010000 


020 


: 10 


16 ; 





DCl 


00010001 


021 


11 


17 


1 


DC2 


00010010 


022 


12 


18 


2 


DCS 


00010011 


023 


13 


19 


3 


DC4 


00010100 


024 


14 


20 


4 


NAK 


00010101 


025 


15 


21 


5 


SYNC 


oooioiio 


026 


16 


22 


6 


EtB 


00010111 


027 


17 


23 


7 ■;. 


CAN 


0001 lOOG 


030 


;■ 18 '■,:■■ 


24 


8 


■:r:':EM:; 


i oooiioor 


031: 


'■:"19[.' 


25 


:■ ■g.:: 


■f^^UB,; 


oooiioio: 


: 032 


■Ih;.]' 


26 




;;^::;£SC' 


00011011 


033;: 


''•■■IB; ■ 


27 


■-■;',■,■:: 


'.eBS.r, 


OOOIIIOO 


034; 


..riC'::.. 


28 


:;-<.;;; 


'■■SW: 


,:;:()00:i:i;i:Oi. 


;,;;b3S;' 


i'Mii 


29 


■■:m. 


■',;':is:;': 


■;,?do6lill0^,'' 


-\036.' 


''MV: 


30 


■ :,'l>.,;.„ 


'■■/■■iUS:;.;,.: 


,;:::OOOIi:i:lI, 


:i;o37' 


■;■'': IF.:;;!.: 


31 


:;:;■?;;■■, 



;,::/:,;:;.::;:s;;EQoiWALENa^;;K>RM:S;: 
:;;;; ;Biiiary ;;?;: ;;Oct:,.;; ;;]Hex^.:;;.;;;pcc; 

.j:(]lG:l:0(gp;::iS^ 

;J6®0OQJ;;';.;:> 
;;00lflfeO;::;l:042;..i^ 
I.i3;l:jW):||i:;|®;^ 
■•-OoiOOlW';:';^ 

jyio0iiO:.";':|^;!S6;^';":^^^ 

■■;;'ooi(Wi:i:i.::;;;,(M7;;;;.;;2^ 

.:v:oOioib(W:'.::':i;05^^ 

.■:ooioi.obiv^;''o5i:.;.,;..;29.'"'-;'.''4ir 

■^OOIOIOIO'.; ',..i052':. ;■;,' ;2A; '''::•;■; .42:^ 

00101011 : 053 ;;2B:; : 43.; 

00101100 054: : 2C ; 44 

00101101 055 2D 45 

00101110 056 2E : 46 

00101111 057 2F 47 
00110000 060 30 48 
00110001; 061 ; 31 49 

00110010 062 32 50 

00110011 : 063 33 51 

00110100 i 064 34 52 

00110101 L065 35 53 

00110110 ; 066 36 54' 

00110111 067 37 55 
OOlilOOO ; 070 ::38 /56i 
OOllldOi:] 071;: 39 ;: 57; 

; 00111010 :; 072 ;:3a:;!:;58::; 

;001i 101 i;i;::073 ;:.;;;:, 3B' ;■;;;■;;. 59^::' 

1 00111.100 J: ::074;:.:; .;:: ZC} ■:':'■ ^66^ 
: :OGli*iqiVl: ; 075;; :;;;3D ;;:[:.;: dx:;;. 

;;ooi;i.ii.i:o;.!.:.'.'.076.:';"i3E ■;■'.! v;62':.; 

.:.-001I ll.W;;i';;07.7;;.,:.,<.;3F'; ■ ; ;, '.:63,';; 



:A:seM:; 

.'.Ghaii'; 



::;.;i::;;EQ(^I^ALENrof ORMS;:,; 
;:Binar3^.;;;:'".'' 'Oct:':;; ;;Hexy ; v:.'0ec; . 



ASCII 

;:C^ar;::; 



:.:;.;:::.;, .E:Qyi;VALENT:.EORWa'' :::, 
-Bm*ri^' ;:7:;;;()w;';;f';H*ii!:'''"' .^0«c 



::;01»WO,;,.:,:;1»,:; ::;::;40:;.:;:.;; :::,;:..» 

.K(JO®:is:;;.;|:M';; 

SlOOqOl:!;;:::^ 
j||0Mim':;-'S;04;' ;::■'; 

'~0mmMiim0o^J:m 

JSlWiM;:;i:'::l:06;.: 
:.;0.100(J1 J;t';.";::I07.:::: ;:47;::;;'V:;7:l'' ;• 
;;'0i»:iOO<j:;;'-:;f:i:iq.;,;::;;v 
;::Olopi001..;:;l.l;i:;;;,;;:;49V,:;::73.:.' 
QlOOiOlO : 112 o;4A 74 
jOlOpiOli: 113: , 4B; : 75 : 

01001100 114 4C 76 

01001101 115 4D 77 
OlWlllO 116 4E 78 
01001111 :117 4F 79 

01010000 120 50 80 

01010001 121 51 81 

01010010 122 52 82 

01010011 123 53 83 

01010100 124 54 84 

01010101 125 55 85 

01010110 126 56 86 

01010111 127 : 57 87 
OlOllOOO 130:; 58 88 

: piOllOOl ;:131 : ;59:^ 89 
rOlOllOlO 132;; 5A: 90l 
1 :0101I01:1; 'yvlSS ■■.■■■■■ '.M: ;■,;■.■ 91; 
[ :oi,pii:ioo;;: ;; ;134,;. ;.:' Isc,:;': '•■■W. ' 

r 01.dlkpt;\;ji35 ;;' : ;5J3:;;;;;;';93:' ; 
:; 0:101:11 10;':":i3:6";';;,';.5e:.'.:'''.; 
»:0.10:l:llll;'::';;l#: ::■;■:; 5F,.;''..:;;'95.: 



'filOfMl--; 

::;p|lflO()lQ!;; %imii:i;:MM:y[ ^^ ^ 

:;:Oli:0qi|i;:;;:;l^^^^ : ; ,; :' , 99' ; ' 

:%ilMW:;.;:i;4iS::'.'^%^::?^^ 

;;Mi;w:i:qi:;';:vli45 ;;;; ' ^ loi 
;:6i.iWii;q.;J:;,;i.46;,:;;;' "66 ; ' '" ri:02 
::fli joo.ii:l^ '1147.;';": ;67;^;, .:i03 
::;Si&iOOO':::;:;:150' ■':,:' 68;: V 1:04 

: oiioioO:!:; ; i5i; ; 69r : los 

01101010 :; 152 : :6A 106 

pllOlOll:;,; 153 68 107 

01 101 100 154 6C 108 

01101101 155 6D 109 

01101110 156 6E 110 

01101111 157 6F 111 

01110000 160 70 112 

01110001 161 71 113 
01110010 162 72 114 
OUIOOU 163 : 73 115 

: 01110100 I 164 I 74 116 

; 01110101 i 165 I 75 117 

\ 01110110 i 166 I 76 118 

I 011101il:| 167 : 77 ;; 119 

oiiiiooO':Li7o :;78; ■ 120 

iOllilOOl f; 171 79 ; ;: 121 
01111010 ;:172;;: 7A:; 122 
: 01 11101 i;;:j^^^^^^ 

.-pli.lli00:';;174.:':'':,7;C.::':::124 
::OH.lt:101::::::;:17:5,.;V':.:.7D.!..;;,125 
;oi:ii.l:il'p,: :;;:;ij;76' :.":\'::7E .;':':■ 126' 
::.;;01:11:11:11::;:.;:;.:177;....;' ..7F ";';'i| '127 
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The following table gives the octal value for an ASCII character in the most significant byte 
("First Character" column) and the least significant byte ("Second Character" column) of a 
word. The diagram illustrates the positions of the first and second character positions of a word. 



First Character 



Second Character 



' ' 1 


15 


14 


13 


12 


11 


10 


9 


8 


7 


6 


5 


4 


3 


2 


1 






ASCII 


First Character 


Second Character 


Character 


Octal Equivalent 


Octal Equivalent 


NUL 


000000 


000000 


SOH 


000400 


000001 


STX 


001000 


000002 


ETX 


001400 


000003 


EOT 


002000 


000004 


ENQ 


002400 


000005 


ACK 


003000 


000006 


BEL 


003400 


000007 


BS 


004000 


000010 


HT 


004400 


000011 


LF 


005000 


000012 


VT 


005400 


000013 


FF 


006000 


000014 


CR 


006400 


000015 


SO 


007000 


000016 


SI 


007400 


000017 


DLE 


010000 


000020 


DCl 


010400 


000021 


DC2 


011000 


000022 


DC3 


011400 


000023 


DC4 


012000 


000024 


NAK 


012400 


000025 


SYN 


013000 


000026 


ETB 


013400 


000027 


CAN 


014000 


000030 


EM 


014400 


000031 


SUB 


015000 


000032 


ESC 


015400 


000033 


FS 


016000 


000034 


GS 


016400 


000035 


RS 


017000 


000036 


US 


017400 


000037 


SF 


020000 


000040 


I 


020400 


000041 


" 


021000 


000042 


# 


021400 


000043 


$ 


022000 


000044 



ASCII 


First Character 


Second Character 


Character 


Octal Equivalent 


Octal Equivalent 


% 


022400 


000045 


& 


023000 


000046 


' 


023400 


000047 


( 


024000 


000050 


) 


024400 


000051 


* 


025000 


000052 


+ 


025400 


000053 


, 


026000 


000054 


- 


026400 


000055 




027000 


000056 


/ 


027400 


000057 





030000 


000060 


1 


030400 


000061 


2 


031000 


000062 


3 


031400 


000063 


4 


032000 


000064 


5 


032400 


000065 


6 


033000 


000066 


7 


033400 


000067 


8 


034000 


000070 


9 


034400 


000071 




035000 


000072 


; 


035400 


000073 


< 


036000 


000074 


= 


036400 


000075 


> 


037000 


000076 


? 


037400 


000077 


@ 


040000 


000100 


A 


040400 


000101 


B 


041000 


000102 


C 


041400 


000103 


D 


042000 


000104 


E 


042400 


000105 


F 


043000 


000106 


G 


043400 


000107 


H 


044000 


000110 


I 


044400 


000111 
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ASCII 


First Character 


Second Character 


Character 


Octal Equivalent 


Octal Equivalent 


J 


045000 


000112 


K 


045400 


000113 


L 


046000 


000114 


M 


046400 


000115 


N 


047000 


000116 


O 


047400 


000117 


P 


050000 


000120 


Q 


050400 


000121 


R 


051000 


000122 


S 


051400 


000123 


T 


052000 


000124 


U 


052400 


000125 


V 


053000 


000126 


W 


053400 


000127 


X 


054000 


000130 


Y 


054400 


000131 


Z 


055000 


000132 


[ 


055400 


000133 


\ 


056000 


000134 


] 


056400 


000135 


A 


057000 


000136 


8 


057400 


000137 


' 


060000 


000140 


a 


060400 


000141 


b 


061000 


000142 


c 


061400 


000143 


d 


062000 


000144 



ASCII 


First Character 


Second Character 


Character 


Octal Equivalent 


Octal Equivalent 


e 


062400 


000145 


f 


063000 


000146 


9 


063400 


000147 


h 


064000 


000150 


i 


064400 


000151 


J 


065000 


000152 


k 


065400 


000153 


1 


066000 


000154 


m 


066400 


000155 


n 


067000 


000156 


o 


067400 


000157 


P 


070000 


000160 


q 


070400 


000161 


r 


071000 


000162 


s 


071400 


000163 


t 


072000 


000164 


u 


072400 


000165 


V 


073000 


000166 


w 


073400 


000167 


X 


074000 


000170 


V 


074400 


000171 


z 


075000 


000172 


{ 


075400 


000173 


h 


076000 


000174 


} 


076400 


000175 


'V 


077000 


000176 


DEL 


077400 


000177 
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Appendix O 

Machine Instructions 



Detailed List 



Instruction 



Form 



Group 



Description 



Page 



AAR 



ABR 



ADA 



{n} 



::{n} 



{loc}[, I] 



Shift/Rotate 



Shift/Rotate 



Integer Math 



ADB 



{loc}[, I] 



Integer Math 



Shifts the A register right the indicated number of 
bits with the sign bit filling all vacated bit positions. 
(Arithmetic right) 

Shifts the B register right the indicated number of 
bits with the sign bit filling all vacated bit positions. 
(Arithmetic right) 

Adds the contents of the specified location to the 
contents of register A. The result is in A. If a carry 
occurs, Extend is set, otheryvise Extend is un- 
changed. If an overflow occurs, Overflow is set, 
otherwise Overflow is unchanged. A carry is from 
bit 15; an overflow is a carry from bit 15 or 14, but 
not both. Extend and Overflow are bits in the pro- 
cessor. Specifying register R4, R5, R6, or R7 as 
the location causes an input I/O bus cycle to the 
interface addressed by the Pa register. Indirect 
addressing may be specified, {loc} must be on 
base or current page. 

Adds the contents of the specified location to the 
contents of register B. The result is in B. If a carry 
occurs, Extend is set, otherwise Extend is un- 
changed. If an overflow occurs. Overflow is set, 
otherwise Overflow is unchanged. A carry is from 
bit 15; an overflow is a carry from bit 15 or 14, but 
not both. Extend and Overflow are bits in the pro- 
cessor. Specifying register R4, R5, R6, or R7 as 
the location causes an input I/O bus cycle to the 
interface addressed by the Pa register. Indirect 
addressing may be specified. {loc} must be on 
base or current page. 



40 



40 



35 



35 
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Instruction 


Form 


Group 


Description 


Page 


AND 


FiND{loc}[,I] 


Logical 


Logical "and" operation. The contents of the A 
register are compared, bit by bit, with the contents 
of the specified location. For each bit comparison 
a 1 results if both bits are I's, a results otherwise. 
The 16-bit result is left in A. Specifying register 
R4, R5, R6, or R7 causes an input bus cycle to the 
interface addressed by the Pa register. Indirect 
addressing may be specified, {loc} must be on 
base or current page. 


41 


CBL 


'■■''' 


Stack 


Clears the Cb register. Specifies the lower block of 
memory for byte-referencing stack instructions. 


43 


CBU 




Stack 


Sets the Cb register. Specifies the upper block of 
memory for byte-referencing stack instructons. 


43 


CDC 




BCD Math 


Clears Decimal Carry explicitly. 




CLA 




Shift 


Clears register A. This is exactly equivalent to SAR 
16. 


41 


CLB 




Shift 


Clears register B. This is exactly equivalent to SBR 
16. 


41 


CLR 


Ci R{n} 


Load/Store 


Clears the specified number of words, beginning 
at the location pointed at by the A register. A 
maximum of 16 words may be cleared. 


34 


CMA 




Memory 


Perform a one's complement of the A register (bit 
by bit inversion of all 16 bits). 


41 


CMS 


C M 1:3 


Memory 


Perform a one's complement of the B register (bit 
by bit inversion of all 16 bits). 


41 


CMX 




BCD Math 


Ten's complement of Arl. The mantissa of Arl is 
replaced with its ten's complement and Decimal 
Carry is cleared. 


45 


CMY 




BCD Math 


Ten's complement of Ar2. The mantissa of Ar2 is 
replaced with its ten's complement and Decimal 
Carry is cleared. 


46 


CPA 


{loc}[,I] 


Test/Branch 


Compares the contents of register A with the con- 
tents of the specified location and skips if they are 
unequal. Indirect addressing may be specified. 
Specifying register R4, R5, R6, or R7 causes an 
input bus cycle to the interface addressed by the 
Pa register, {loc} must be on base or current page. 


37 
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Instruction 


Form 


Group 


Description 


Page 


CPB 


CPB{loc}[,I] 


Test/Branch 


Compares the contents of register B with the con- 
tents of the specified location and skips if they are 
unequal. Indirect addressing may be specified. 
Specifying register R4, R5, R6, or R7 causes an 
input bus cycle to the interface addressed by the 
Pa register, {loc} must be on base or current page, 
{loc} must be on base or current page. 


37 


DBL 




Stack 


Clears the Db register. Specifies the lower block of 
memory for byte-referencing stack instructions. 


43 


DBU 




Stack 


Sets the Db register. Specifies the upper block of 
memory for byte-referencing stack instructions. 


43 


DDR 




I/O 


Disables Data Request. Cancels the DMA 
instruction. 


47 


DIR 


D I F? 


I/O 


Disables the interrupt system. Cancels the EIR 
instruction. 


47 


DMA 


Df' ^ 


I/O 


Enables the DMA mode. Cancels the DDR 
instruction. 


47 


DRS 




BCD Math 


Mantissa right shift of ArX for one digit. The 
twelfth digit is shifted into bits 0-3 of the A regis- 
ter. The non-digit part of the A register is cleared 
(bits 4-15), and the Decimal Carry bit in the pro- 
cessor is cleared. The first digit in the mantissa is 
set to 0. 


45 


DSZ 


{loc}[,I] 


Test/ Alter/Branch 


Decrements the contents of the specified location 
and skips if the new contents are 0. Specifying 
register R4, R5, R6, or R7 causes an input (or an 
input and an output) bus cycle to the interface 
addressed by the Pa register. Indirect addressing 
may be specified, {loc} must be on base or current 
page. 


38 


EIR 




I/O 


Enables the interrupt system. Cancels the DIR in- 
struction. 


47 
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Instruction 



Form 



Group 



Description 



Page 



EXE 



{reg}[, I] 



Miscellaneous 



FDV 



BCD Math 



FMP 



BCD Math 



FXA 



BCD Math 



lOR 



{loc}[, I] 



Logical 



Executes the contents of a register, {reg} is an in- 47 
teger in the range of through 31, indicating the 
register to be used (see Memory Map for the cor- 
respondence between location and register). The 
register is left unchanged unless the instruction 
code causes it to be altered. The next instruction 
to be executed is the one following the EXE, un- 
less the code in the executed register causes a 
branch. Indirect addressing may be specified. 

Fast divide. The mantissas of Arl and Ar2 are 46 
added together, along with Decimal Carry, until 
the first decimal overflow occurs. The result ac- 
cumulates into Ar2. The number of additions 
without overflow is placed into the lower 4 bits of 
the B register (0-3). The remainder of the B regis- 
ter is cleared, as is the Decimal Carry bit in the 
processor. 

Fast Multiply. Performs the multiplication by re- 46 
peated additions. The mantissa of Arl is added to 
Ar2 along with Decimal carry, a specified number 
of times. The number of times is specified in the 
lower 4 bits (0-3) of the B register. The result ac- 
cumulates in Ar2. If intermediate overflows occur, 
the number of times they occur appears in the 
lower 4 bits of the A register after the operation is 
complete. The upper 12 bits of the A register are 
cleared along with Decimal Carry. 

Fixed-point addition. The mantissas of Arl and 46 
Ar2 are added together and the result placed in 
Ar2. Decimal Carry is used as the twelfth digit. 
After the addition, Decimal Carry is set if an over- 
flow occurred, otherwise Decimal Carry is cleared. 

Logical "inclusive or" operation. The contents of 41 
the A register are compared, bit by bit, with the 
contents of the specified location. For each bit 
comparison, a results if both bits are O's, a 1 
otherwise. The 16-bit result is left in A. Specifying 
register R4, R5, R6, or R7 causes an input bus 
cycle to the interface addressed by the Pa register. 
Indirect addressing may be specified, {loc} must 
be on base or current page. 
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Instruction 


Form 


Group 


Description 


Page 


ISZ 


i:z{ioc}[,]] 


Test/ Alter/Branch 


Increments the contents of the specified location 
and skips if the new contents are 0. Specifying 
register R4, R5, R6, or R7 causes an input (or an 
input followed by an output) bus cycle to the inter- 
face addressed by the Pa register. Indirect addres- 
sing may be specified, {loc} must be on base or 
current page. 


38 


JMP 


{loc}[, I] 


Branch 


Unconditionally branches to the specified loca- 
tion. Indirect addressing may be specified, {loc} 
must be on base or current page. 


36 


JSM 


JSM {loc} [, I] 


Branch 


Jumps to subroutine. The value of the R register 
is incremented by 1 and the value of the P regis- 
ter (i.e., the location of the JSM instruction itself) 
is stored in the address pointed to by the R regis- 
ter. Execution then proceeds to the specified lo- 
cation. Return from the subroutine is effected by 
the RET instruction. Indirect addressing may be 
specified, {loc} must be on base or current page. 


36 


LDA 


{loc} [ , I ] 


Load/Store 


Loads register A with the contents of the 
specified location. Specifying register R4, R5, 
R6, or R7 causes an input I/O bus cycle to the 
interface addressed by the Pa register. Indirect 
addressing maybe specified, {loc} must be on 
base or current page. 


34 


LDB 


LDB {loc} [, I] 


Load/Store 


Loads register B with the contents of the 
specified location. Specifying register R4, R5, 
R6, or R7 causes an input I/O bus cycle to the 
interface addressed by the Pa register. Indirect 
addressing may be specified, {loc} must be on 
base or current page. 


34 


MLY 


MLY 


BCD Math 


Mantissa left shift on Ar2 for one digit. This is a 
circular shift, with the bits 0-3 of the A register 
forming a thirteenth digit. The non-digit part of 
the A register is cleared (bits 4-15), and the Dec- 
imal Carry bit in the processor is cleared. 


45 



212 Appendix B: Machine Instructions 



Instruction 



Form 



Group 



Description 



Page 



MPY 



Integer Math 



MRX 



BCD Math 



MRY 



BCD Math 



Binary multiply. Uses Booth's Algorithm. The 35 
values of the A and B registers are multiplied to- 
gether with the product placed into A and B. The 
A register contains the least significant bits and 
the B register contains the most significant bits 
and the sign. B may contain any integer value 
except - 32 768. 

Mantissa right shift on Arl. The number of digits 44 
to be shifted is specified in the lower 4 bits (0-3) 
of the B register. The shift is accomplished in 
three stages: 

1) Bits 0-3 of the A register are right-shifted into 
Di of the mantissa, with the twelfth digit 
being lost. This is the first shift. This shift al- 
ways takes place, even if B = 0. 

2) The digits are then right-shifted for the re- 
maining number of digits specified. The 
twelfth digit is lost on each shift (except for 
the last shift) and the vacated digits are zero- 
filled. 

3) Finally, the last right-shifting takes place, 
with the twelfth digit shifting into the lower 4 
bits (0-3) of the A register. The Decimal 
Carry bit in the processor is cleared and the 
non-digit part of the A register is cleared (bits 
4-15). 

Mantissa right shift on Ar2. The number of digits 45 
to be shifted is specified in the lower 4 bits (0-3) 
of the B register. The shift is accomplished in 
three stages: 

1) Bits 0-3 of the A register are right-shifted into 
Di of the mantissa, with the twelfth digit 
being lost. This is the first shift. This shift al- 
ways takes place, even if B = 0. 

2) The digits are right-shifted for the remaining 
number of digits specified. The twelfth digit 
is lost on each shift (except for the last shift) 
and the vacated digits are zero-filled. 



'i snciix 



}', -'-'"..acuintE 



Instruction 



Form 



Group 



Description 



Page 



MWA 



NOP 



NRM 



PBC 



PBD 



{reg}[, I] 



{reg} 
{reg}[, I] 



3) Finally, the last right-shifting takes place, 
with the twelfth digit shifting into the lower 4 
bits (0-3) of the A register. The non-digit part 
of the A register is cleared (bits 4-15), and 
the Decimal Carry bit in the processor is 
cleared. 

BCD Math Mantissa word addition. The contents of the B 46 

register are added to the ninth through twelfth 

digits of the Ar2 register. Decimal Carry is added 

to the twelfth digit; if an overflow occurs, Deci- 

mal Carry is set, otherwise Decimal Carry is 

i cleared. 

I 

Miscellaneous | Null operation. This is exactly equivalent to LDA 47 

I A. 

BCD Math , Normalizes the Ar2 mantissa. Up to twelve left- 45 
; shifts of the mantissa are performed until the first 
digit of the mantissa is non-zero. If the original 
first digit is already non-zero, no shifts occur. The 
I number of shifts required is stored in the first 4 
bits (0-3) of the B register. If 12 shifts are re- 
quired, the Decimal Carry bit in the processor is 
set; otherwise, the Decimal Carry bit is cleared. 
The exponent is not altered. 

Stack Pushes the lower byte (right half) of the specified 43 

register onto the stack pointed at by the Cb and C 
registers. Specifying register R4, R5, R6, or R7 
causes an input I/O bus cycle to the interface ad- 
dressed by the Pa register. Incrementing or de- 
crementing of the C register can be specified. In- 
crementing is the default, {reg} must be in the 
range of through 7. The incrementing or decre- 
menting action takes place before pushing. 

Stack Pushes the lower byte (right half) of the specified 43 

i 
j register onto the stack pointed at by the Db and D 

! registers. Specifying register R4, R5, R6, or R7 

I causes an input I/O bus cycle to the interface ad- 

i dressed by the Pa register. Incrementing or dec- 

i rementing the D register can be specified. Incre- 

1 menting is the default, {reg} must be in the range 

i of through 7. The incrementing or decrementing 

i action takes place before pushing. 
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Form 
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Page 


PWC 


PWC {rcg} , D 
PWC{rcg}[, I] 


Stack 


Pushes entire register (full word) onto the stack 
pointed at by the C register. Specifying register 
R4, R5, R6, or R7 causes an input I/O bus cycle to 
the interface addressed by the Pa register. Incre- 
menting or decrementing the C register may be 
specified. Incrementing is the default, {reg} must 
be in the range of through 7. The incrementing 
or decrementing action takes place before 
pushing. 


43 


PWD 


PWD {reg} , D 
PWD{reg}[, I] 


Stack 


Pushes the entire register (full word) onto the 
stack pointed at by the D register. Specifying 
register R4, R5, R6, or R7 causes an input I/O bus 
cycle to the interface addressed by the Pa register. 
Incrementing or decrementing the D register may 
be specified. Incrementing is the default, {reg} 
must be in the range of through 7. The 
incrementing or decrementing action taken place 
before pushing. 


43 


RAL 


RmL {n} 


Shift/Rotate 


Rotates the A register left the indicated number of 
bits. Bit 15 rotates into bit (left circular). 
Maximum rotation of 16 bits. 


40 


RAR 


RflR{n} 


Shift/Rotate 


Rotates the A register right the indicated number 
of bits. Bit rotates into bit 15 (right circular). 
Maximum rotation of 16 bits. 


40 


RBL 


RBL{n} 


Shift/Rotate 


Rotates the B register left the indicated number of 
bits. Bit 15 rotates into bit (left circular). 
Maximum rotation of 16 bits rotated. 


40 


RBR 


RBR {n} 


Shift/Rotate 


Rotates the B register right the indicated number 
of bits. Bit rotates into bit 15 (right circular). 
Maximum rotation of 16 bits. 


40 


RET 


RET{n} 


Branch 


Returns from subroutine, {n} is added to the con- 
tents of the address pointed to by the R register. 
The R register is decremented by 1. This is, in 
effect, a return from a JSM instruction (see 
above), to {n} instructions following the JSM itself. 
The "usual" return is RET 1. {n} must be in the 
range of - 32 through 31. 


36 
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Form 


Group 


Description 


Page 


RIA 


Rin{adrs} 


Test/Branch 


Skips to {adrs}if register A is not 0, then incre- 
ments register A by 1. Extend and Overflow are 
not effected by the incrementing action, even if a 
carry or overflow occurs, {adrs} must be within 
- 32 and + 31 of the current location. 


37 


RIB 


RIB {adrs} 


Test/Branch 


Skips to {adrs} if register B is not 0, then incre- 
ments register B by 1. Extend and Overflow are 
not affected by the incrementing action, even if a 
carry or overflow occurs, {adrs} must be within 
- 32 and + 31 oi the current location. 


37 


RLA 


F?i H{adrs}[,S] 

Ri H{adrs}[,C] 


Test/Alter/Branch 


Skips to {adrs} if the least significant bit of the A 
register is not 0. Setting or clearing the bit after the 
test can be specified, {adrs} must be within - 32 
and -1- 31 of the current location. 


39 


RLB 


Rl B{adrs}[,S] 
Ri H{adrs}[,C] 


Test/ Alter/Branch 


Skips to {adrs} if the least significant bit of the B 
register is not 0. Setting or clearing the bit after the 


39 






test can be specified, {adrs} must be within - 32 










and -1- 31 the current location. 




RZA 


RZR{adrs} 


Test/Branch 


Skips to {adrs} if register A is not 0. {adrs} must be 
within - 32 and -1- 31 of the current location. 


37 


RZB 


RZB {adrs} 


Test/Branch 


Skips to {adrs} if register B is not 0. {adrs} must be 
within - 32 and + 31 of the current location. 


37 


SAL 


SiRL {n} 


Shift/Rotate 


Shifts the A register left the indicated number of 
bits with all vacated bit positions becoming 0. 
Maximum shift is 16 bits. 


40 


SAM 


SRM{adrs}[, S] 

SRh1{adrs}[, C] 


Test/ Alter/Branch 


Skips to {adrs} if the A register is negative (bit 15 is 
1). Setting or clearing the bit after the test can be 


38 






specified, {adrs} must be within - 32 and -1- 31 of 










the current location. 




SAP 


SRP{adrs}[, S] 
SRR {adrs} [, C] 


Test/ Alter/Branch 


Skips to {adrs} if the A register is positive or zero 
(bit 15 is 0). Setting or clearing the bit after the test 
can be specified, {adrs} must be within - 32 and 
-1- 31 of the current location. 


38 


SAR 


SRR {n} 


Shift/Rotate 


Shifts the A register right the indicated number of 
bits with all vacated bit positions becoming 0. 
Maximum shift is 16 bits. 


40 
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SBL 


SBL {n} 


Shift/Rotate 


Shifts the B register, left the indicated number of 
bits with all vacated bit positions becoming 0. 
Maximum shift is 16 bits. 


40 


SBM 


SBM {adrs} [, S] 


Test/ Alter/Branch 


Skips to {adrs} if the B register is negative (bit 15 is 


38 




SBM {adrs} [, C] 


Test/ Alter/Branch 


1). Setting or clearing the bit after the test can be 
specified, {adrs} must be within - 32 and + 31 of 
the current location. 




SEP 


SBP{adrs}[, S] 
SBP{adrs}[, C] 


Test/ Alter/Branch 


Skips to {adrs} if the B register is positive (bit 15 is 
0). Setting or clearing the bit after the test can be 
specified, {adrs} must be within - 32 and + 31 of 
the current location. 


38 


SBR 


SBR {n} 


Shift/Rotate 


Shifts the B register right the indicated number of 
bits with all vacated bit positions becoming 0. 
Maximum shift is 16 bits. 


40 


SDC 


SDC {adrs} 


BCD Math 


Skips to {adrs} if Decimal Carry is clear. Decimal 
carry is a single bit in the processor which may 
have been set by certain arithmetic operations, 
{adrs} must be within - 32 and + 31 of the cur- 
rent location. 


46 


SDI 


C; n T 


I/O 


Sets DMA inwards. Reads from peripheral, writes 
to memory. 


47 


SDO 


SDO 


I/O 


Sets DMA outwards. Reads from memory, writes 
to peripheral. 


47 


SDS 


SDS {adrs} 


BCD Math 


Skips to {adrs} if Decimal Carry is set. Decimal 
carry is a single bit in the processor which may 
have been set by certain arithmetic operations, 
{adrs} must be with - 32 and + 31 of the current 
location. 


46 


SEC 


SEC {adrs} [,S] 
SEC {adrs} [,C] 


Test/ Alter/Branch 


Skips to {adrs} if Extend is clear. Extend is a single 
bit in the processor which may have been set by 
certain arithmetic operations. Setting or clearing 
the bit after the test can be specified, {adrs} must 
be within - 32 and + 31 of the current location. 


39 
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Form 
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Page 


SES 


.: :{adrs}[,S] 
SE:S {adrs} [, C] 


Test/ Alter/Branch 


Skips to {adrs} if Extend is set. Extend is a single 
bit in the processor which may have been set by 
certain arithmetic operations. Setting or clearing 
the bit after the test can be specified, {adrs} must 
be within — 32 and + 31 of the current location. 


39 


SFC 


{adrs} 


I/O 


Skips to {adrs} if the Flag line is false (clear). The 
Flag line is the one associated with a peripheral on 
the current select code (pointed to by the Pa regis- 
ter), {adrs} must be within - 32 and + 31 of the 
current location. 


47 


SFS 


{adrs} 


I/O 


Skips to {adrs} if the Flag line is true (set). The flag 
line is that associated with the peripheral on the 
current select code (pointed to by the Pa register), 
{adrs} must be within - 32 and + 31 of the current 
location. 


47 


SIA 


{adrs} 


Test/Branch 


Skips to {adrs} if register A is 0, then increments 
register A by 1. Extend and Overflow are not af- 
fected by the incrementing action, even if a carry 
or overflow occurs, {adrs} must be within - 32 
and -1- 31 of the current location. 


37 


SIB 


{adrs} 


Test/Branch 


Skips to {adrs} if register B is 0, then increment 
register B by 1. Extend and Overflow are not af- 
fected by the incrementing action, even if a carry 
or overflow occurs, {adrs} must be within — 32 
and -t- 31 of the current location. 


37 


SLA 


{adrs}[,S] 
{adrs}[,::] 


Test/ Alter/Branch 


Skips to {adrs} if the least significant bit of the A 
register is 0. Setting or clearing the bit after the 


38 






test can be specified, {adrs} must be within - 32 










and -1- 31 of the current location. 




SLB 


Si B{adrs}[,C] 

S\ B{adrs}[,S] 


Test/ Alter/Branch 


Skips to {adrs} if the least significant bit of the B 
register is 0. Setting or clearing the bit after the 
test can be specified, {adrs} must be within - 32 
and -1- 31 of the current location. 


39 
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soc 


SOC {adrs} [,S] 
so: {adrs} [, C] 


Test/ Alter/Branch 


Skips to {adrs} if Overflow is clear. Overflow is a 
single bit in the processor which may have been 


39 






set by certain arithmetic operations. Setting or 










clearing the bit after the test can be specified. 










{adrs} must be within - 32 and + 31 of the cur- 










rent location. 




SOS 


SOS {adrs} [,S] 
SOS {adrs} [, C] 


Test/ Alter/Branch 


Skips to {adrs} if the Overflow is set. Overflow is a 
single bit in the processor which may have been 


39 






set by certain arithmetic operations. Setting or 










clearing the bit after the test can be specified. 










{adrs} must be within - 32 and + 31 of the cur- 










rent location. 




ssc 


SSC {adrs} 


I/O 


Skips to {adrs} if Status line is false (clear). The 
status line is the one associated with the peripheral 
on the current select code (pointed to by the Pa 
register), {adrs} must be within - 32 and + 31 of 
the current location. 


47 


sss 


SSS {adrs} 


I/O 


Skips to {adrs} if the Status line is true (set). The 
status line is the one associated with the peripheral 
on the current select code (pointed to by the Pa 
register), {adrs} must be within - 32 and -^ 31 of 
the current location. 


47 


STA 


STR{loc}[, I] 


Load/Store 


Stores the contents of the A register into the 
spcified location. Specifying register R4, R5, R6, 
or R7 causes an output bus cycle to the interface 
addressed by the Pa register. Indirect addressing 
may be specified, {loc} must be on base or current 
page. 


34 


STB 


STB{Ioc}[. I] 


Load/Store 


Stores the contents of the B register into the 
specified location. Specifying register R4, R5, R6, 
or R7 causes an output bus cycle to the interface 
addressed by the Pa register. Indirect addressing 
may be specified, {loc} must be on base or current 
page. 


34 


SZA 


SZfl{adrs} 


Test/Branch 


Skips to {adrs} if register A is 0. {adrs} must be 
within - 32 and -1- 31 of the current location. 


37 


SZB 


SZB {adrs} 


Test/Branch 


Skips to {adrs} if register B is 0. {adrs} must be 
within - 32 and -(- 31 of the current location. 


37 
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TCA 



Integer Math 



TCB 



Integer Math 



WBC 



{reg}[, D] 
{reg} , 



Stack 



WBD 



{reg}[,[J] 
{reg} , I 



Stack 



Performs a two's complement of the A register 
(one's complement, incremented by 1). If a carry 
occurs, Extend is set, otherwise Extend is un- 
changed. If an overflow occurs. Overflow is set, 
otherwise Overflow is unchanged. A carry is from 
bit 15; an overflow occurs when complementing 

- 32 768. Extend and Overflow are bits in the 
processor. 

Performs a two's complement of the B register 
(one's complement, incremented by 1). If a carry 
occurs, Extend is set, otherwise Extend is un- 
changed. If an overflow occurs. Overflow is set, 
otherwise Overflow is unchanged. A carry is from 
bit 15; an overflow occurs when complementing 

- 32 768. Extend and Overflow are bits in the 
processor. 

Withdraws a byte from the stack pointed at by the 
Cb and C registers and places it into the lower byte 
(right half) of the specified register. Specifying 
register R4, R5, R6, or R7 causes an output I/O 
bus cycle to the interface addressed by the Pa 
register. Incrementing or decrementing the C 
register can be specified. Decrementing is the 
default, {reg} must be in the range of through 31. 
The incrementing or decrementing routine takes 
place after the withdrawal. 

Withdraws a byte from the stack pointed at by the 
Db and D registers and places it into the lower byte 
(right half) of the specified register. Specifying 
register R4, R5, R6, or R7 causes an output I/O 
bus cycle to the interface addressed by the Pa 
register. Incrementing or decrementing the D 
register can be specified. Decrementing is the 
default, {reg} must be in the range of through 31. 
The incrementing or decrementing routine takes 
place after the withdrawal. 



35 



35 



43 



43 



220 Appendix B: Machine Instructions 



Instruction 



Form 



Group 



Description 



Page 



wwc 



{reg}[,]J] 
{reg} 



Stack 



WWD 



{reg}[,D] 
{reg} 



Stack 



XFR 



{n} 



Load/Store 



Withdraws a full word from the stack pointed at by 
the C register and places it into the specified 
register. Specifying register R4, R5, R6, or R7 
causes an output I/O bus cycle to the interface 
addressed by the Pa register. Incrementing or 
decrementing of the C register can be specified. 
Decrementing is the default, {reg} must be in the 
range of through 31. The incrementing or 
decrementing action takes place after the 
withdrawal. 

Withdraws a full word from the stack pointed at by 
the D register and places it into the specified 
register. Specifying register R4, R5, R6, or R7 
causes an output I/O bus cycle to the interface 
addressed by the Pa register. Incrementing or 
decrementing of the D register can be specified. 
Decrementing is the default, {reg} must be in the 
range of through 31. The incrementing or 
decrementing action takes place after the 
withdrawal. 

Transfers the specified number of words, from the 
location starting at the address pointed at by the A 
register to the location starting at the address 
pointed at by the B register. A maximum of 16 
words can be transferred. 



43 



43 



34 



Alphabetic List 
Bit Patterns and Timings 



Instruction 


Bit Pattern 


Timing 


AARn 


15 14 13 


12 11 


10 


9 


8 


7 


6 


5 4 


3 


2 


1 





n+9 


1 1 1 


1 








1 











^ 


T\ ^ 


-1 


-^ 


ABRn 
ADA 


1 1 1 

"^/i 1 


1 1 










1 











<- 


n 


-^ 


n+9 
19 


<- 
















-> 


ADB 


""h 1 


1 


«/c 


<- 








address 








_> 


19 


AND 
CBL 


°/i 1 
1 1 


1 
1 





<r- 
















-^ 


19 
12 





1 





1 





1 











CBU 


1 1 


1 








1 





1 


1 


1 











12 


CDC 


1 1 


1 





1 


1 


1 


1 

















11 


CLA 


1 1 1 


1 








1 





1 





1 


1 


1 


1 


25 


CLB 

CLRn 

CMA 


1 1 1 

1 1 

1 1 1 


1 1 

1 
1 









1 




1 

1 






1 




1 



1 






1 


1 


1 


1 


1 


25 

6n+16 

9 


<- 


n- 


-1 


-> 














CMB 


111 


1 1 














1 


1 














9 


CMX 


1 1 


1 





1 








1 


1 














59 


CMY 
CPA 


1 1 

'^/i 


1 
1 





1 











1 


_0_ 











23 
22 


<- 








dudr6ss 








-^ 


CPB 
DBL 


°h 
1 1 


1 1 

1 





4— 
















-> 


22 

12 










1 

















DBU 


1 1 


1 













1 


1 














12 


DDR 


1 1 


1 
















1 1 


1 











12 


DIR 


1 1 


1 
















1 


1 











12 


DMA 


1 1 


1 
















1 














12 


DRS 

DSZ 

EIR 

EXE 

FDV 


1 1 
% 1 
1 1 

% 1 1 

1 1 


1 1 
1 1 

1 
1 

1 1 




«/c 





1 










1 











1 


56 
25 
12 
14 
37 + 13B 


<- 








address 








-^ 





1 


1 















1 














^ 


register 




-^ 


1 











1 


FMP 


1 1 


1 1 





1 


























42 + 13B(note2) 


FXA 
lOR 


1 1 

% 1 1 


1 






1 





1 




















40 
19 


<- 
















-♦ 


ISZ 


^/i 1 


1 


^/c 


<- 
















-> 


25 


JMP 


^/l 1 1 


1 


«/c 


<- 








SiAt^Ti>QS 








-^ 


14 


JSM 


°/i 1 





«/c 


<- 








OviUI V99 








-> 


23 


LDA 


°/i 





«/c 


<- 
















-> 


19 


LDB 
MLY 


""h 
1 1 


1 

1 1 





<- 
















-^ 


19 
32 




1 





1 


1 











1 


MPY 


1 1 


1 1 







1 


1 








1 


1 


1 


1 


65+2T(note3) 


MRX 


1 1 


1 1 







1 























62+4B(note4) 


MRY 


1 1 


1 1 







1 





1 

















33+4B(note4) 


MWA 


1 1 


1 































28 


NOP 






































11 


NRM 
PBCr 


1 1 
1 1 


1 

1 1 






1 




1 
1 




Vo 


1 
1 




1 















23+Z{note5) 
23 


<- 




— > 


PBDr 


1 1 


1 1 








1 


Vo 


1 


1 


1 


«— 




-^ 


23 


PWCr 


1 1 


1 








1 


'/o 


1 


1 





<- 


r 


— » 


23 


PWDr 


1 1 


1 








1 


'/o 


1 


1 


1 


<- 




— >■ 


23 



Instruction 


Bit Pal 


RALn 


15 14 13 12 11 


10 


9 


8 




I 1 








1 


RARn 




L 1 








1 


RBLn 












1 


RBRn 












1 


RET 




L 1 











RIA 


1 




1 








RIB 


1 




1 








RLA 


1 


I 1 


1 


1 


1 


RLB 


1 : 




1 


1 


1 


RZA 


1 : 




1 








RZB 


1 




1 








SALn 


1 1 : 










1 


SAM 


1 1 


I 1 


1 





1 


SARn 


1 1 ] 










1 


SBLn 


1 1 










1 


SBM 


1 1 : 




1 





1 


SBP 


1 1 ] 




1 








SBRn 


1 1 ] 










1 


SDC 


1 ] 




1 





1 


SDI 


1 : 










1 


SDO 


1 ] 










1 


SDS 


1 


L 1 


1 








SEC 


1 1 




1 


1 





SES 


1 1 




1 


1 


1 


SFC 


1 ] 




1 





1 


SFS 


1 ] 




1 








SIA 


1 ] 




1 





1 


SIB 


1 ] 




1 





1 


SLA 


1 ] 




1 


1 





SLB 


1 ] 




1 


1 





SOC 


1 1 ] 




1 


1 





SOS 


1 1 ] 




1 


1 


1 


ssc 


1 ] 




1 





1 


SSS 
STA 


1 ] 

°/i ] 


L 1 


1 








<- 




STB 
SZA 


°/i ] 
1 ] 


I 10 


1 


<- 







1 


SZB 


1 ] 




1 





1 


TCA 


1 1 ] 


L 1 











TCB 


1 1 ] 













WBCr 


1 ] 










1 


WBDr 


1 ] 










1 


WWCr 


1 ] 


[ 1 








1 


WWDr 


1 ] 


L 1 








1 


XFRn 


1 ] 


[ 1 





1 


1 
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Instruction 








Bit Pattern 










Timing 


RALn 
RARn 
RBLn 
RBRn 
RET 


15 14 13 12 11 


10 


9 


8 


7 


6 


5 


4 


3 2 1 





25-n 
n+9 

25-n 

n+9 

16 




L 1 
I 1 

i 1 
















1 
1 

1 
1 




1 

1 
1 
1 

1 


1 
1 
1 
1 
















^ 15-n 


^ 


^ n-1 


-^ 


^ 15-n 


_> 


<e- n-1 


-^ 


<- 






-> 


RIA 


1 : 


I 1 


1 











1 


*- 






-> 


14 


RIB 


1 




1 











1 


<- 






-> 


14 


RLA 


1 : 


[ 1 


1 


1 


1 


"/h 


% 


.«- 




skip 


-^ 


14 


RLB 


1 




1 


1 


1 


"/h 


7s 


<— 






-^ 


14 


RZA 


1 


1 


1 














<- 






-> 


14 


RZB 

SALn 

SAM 

SARn 

SBLn 

SBM 


1 

1 1 ] 

1 1 : 

1 1 ] 
1 1 ] 
1 1 ] 


1 


1 



1 




1 












1 

1 
1 
1 
1 




1 



1 

% 





% 
1 




<r- 






— * 


14 
n+9 

14 
n + 9 
n+9 

14 








<^ n-1 


— »• 


<_ 




skip 


_> 










^ n-1 


-^ 


<_ 




skip 


— > 


SBP 
SBRn 
SDC 
SDI 


1 1 ] 
1 1 ] 

1 ] 
1 ] 




1 



1 












1 
1 
1 




1 




1 

1 




<_ 




-^ 


14 

n+9 

14 

12 








<- n-1 


-> 


<_ 




skip 


-^ 








1 





SDO 
SDS 


1 ] 
1 ] 


1 




1 






1 






1 




1 














12 
14 


<r- 






-^ 


SEC 


1 1 ] 




1 


1 





"/h 


% 


<- 






-^ 


14 


SES 


1 1 




1 


1 


1 


"/h 


7s 


<— 






-H. 


14 


SFC 


1 ] 




1 





1 


1 





^ 






-^ 


14 


SFS 


1 ] 




1 








1 





<- 






-^ 


14 


SIA 


1 ] 


1 


1 





1 





1 


<- 






— » 


14 


SIB 


1 ] 




1 





1 





1 


<- 




skip 


-> 


14 


SLA 


1 ] 




1 


1 





"/h 


% 


<- 






—* 


14 


SLB 


1 ] 




1 


1 





"/h 


% 


<_ 






-^ 


14 


SOC 


1 1 ] 


1 


1 


1 





"/h 


7s 


<_ 






-^ 


14 


SOS 


1 1 ] 




1 


1 


1 


"/h 


7s 


<_ 






-^ 


14 


SSC 


1 ] 




1 





1 


1 





<— 






-^ 


14 


sss 

STA 
STB 
SZA 


1 ] 

% ] 
°/< ] 
1 ] 


1 
1 


1 
1 








1 





<- 






-^ 


14 
19 
19 
14 


LZZL. 








address 




-* 





1 








<_ 






— * 


SZB 

TCA 


1 ] 

1 1 ] 


1 


1 








1 












<_ 




skip 


-^ 


14 
9 













TCB 

WBCr 


1 1 ] 

1 ] 














1 




Vo 




1 






1 











9 
23 





<_ 


-^ 


WBDr 


1 ] 










1 


% 


1 




1 


1 


<_ 


-^ 


23 


WWCr 


1 ] 


L 1 








1 


Vo 


1 




1 





r 


_» 


23 


WWDr 
XFRn 


1 ] 
1 ] 


I 1 
I 1 








1 


1 

1 


Vo 




1 







1 




1 


<- 


-^ 


23 

12n+21 


^ n-1 


-^ 







Notes on bit patterns: 

B/C (Base Page /Current Page) 
C/S (Clear/Set) 
D/I (Direct/ Indirect) 
H/H (Hold/Don't Hold) 
I/D (Increment/ Decrement) 



All are coded 0/1 respectively 



skip I if the high bit in the field is 1, the 
address J field is negative (2's complement) 



Notes on timings: 

All timings are maximum clock times. The clock rate is 6 megahertz. Clock times may vary 
up to ± 5% from the clock rate. 

Any operation using register R4, R5, R6, or R7, should add 7 clock times. 

Any operation using register R8, R9, RIO, Rll, R12, R13, R14, or R15 should add 5 clock 
times. 

Maximum interrupt lockout time is 239. 
Minimum interrupt lockout time is 2. 

Maximum DMA lockout time is 10. 
Minimum DMA lockout time is 2. 

Interrupt execution is 36. 

DMA read = 3 + lOn + lockout time | n is the number of words 
DMA write = 3 + 9n + lockout time J transferred during a request 

Note 1. B is the current value in bits through 3 of the B register. 

Note 2. If bits through 3 (B) of the B register are then the total timing is 34. 

Note 3. T is the total number of -» 1 and 1^-0 transitions in the A register (using an 
imaginary to the right of bit 0). 

Note 4. B is the current value in bits through 3 of the B register. If B = 0, then the total timing 
is 26. 

Note 5. Z is the number of leading zeroes in the mantissa of Ar2. If Z = 12, then the total timing 
is 69. 
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Approximate Numerical List 
Bit Patterns 



Instruction 


Bit Pattern 


NOP 


15 14 13 12 11 


10 


9 


8 


7 


6 


5 4 3 2 10 



'^A % 
































<:p% 


% c 


) 1 % 














AD% 


^A ] 


[ % 














ST7b 


% ] 


[ 1 % 














JSM 


'^A 1 C 


) 










Address Field 


AND 


^A 1 C 


) 1 














VoSZ 


7i 1 ( 


) Vo 1 














lOR 


^A 1 ] 


[ 














JMP 
EXE 

SD°/i 


^A 1 J 
°A 1 ] 
1 ] 


L 1 
L 1 
[ 1 





































Register Address 


7> 


%IR 


1 ] 


L 1 
















1 7d 


DMA 


1 ] 


L 1 
















10 


DDK 


1 ] 


[ 1 
















1110 


MWA 


1 ] 
1 ] 
1 ] 


[ 1 

L 1 % 
1 










1 







Vo 



1 

1 




7l 

1 7w 



7c 


% Register Address 





CM^/x 


1 ] 


[ 1 





1 








^/x 


10 


FXA 
XFR 


1 ] 
1 ] 


. 1 
L 1 






1 
1 




1 


1 

















N = # of words 


CLR 
NRM 


1] 
1 ] 


1 
1 






1 

1 


1 

1 


1 






1 





binary = (n-l) 








CDC 


1 ] 


1 





1 


1 


1 


1 





FMP 


1 ] 


1 1 





1 














FDV 


1 ] 


1 1 





1 











10 1 


MRX 


1 ] 


[ 1 1 





1 


1 











DRS 


1 ] 


1 1 





1 


1 








10 1 


MRY 


1 ] 


1 1 





1 


1 





1 





MLY 


1 ] 


1 1 





1 


1 





1 


10 1 


MPY 

S7d^/c 


1 ] 
1 ] 


1 1 
1 





1 




1 

7c 


1 
1 




7d 


1111 


Skip Field 


'^/s^/.^/b 


1] 


. 1 % 







7s 





7. 


if bit 5 is 0, then skip to(P+n), 


s/rL% 


1 ] 


1 % 




1 


7r 


% 


7s 


n=bits 0-4 


SS^c 


1 ] 


[ 1 1 







7c 


1 





if bit 5 = 1, then skip to(P-n), 


S%7m 


1 1 ] 


. 1 % 







7m 


"/h 


7s 


n= two's complement of bits 0-4 


RET 

TC^/b 


1 1 ] 
1 1 ] 
1 1 ] 


1 °/e 

1 

. 1 % 






1 









1 




7s 






complemented skip field 


10 


CM^/b 


1 1 ] 


. 1 % 














1 


10 


CLVb 
AVbR 


1 1 ] 
1 1 ] 


L 1 % 

[ 1 ^/b 
















1 







1111 





Shift Field 


«/s%R 


1 1 ] 


L 1 % 










7s 


1 





insource,n = l-16 


S%L 
R^/bL 


1 1 ] 
1 1 ] 


. 1 ^/b 

L 1 % 












1 

1 




1 






binary=(n-l) 


complemented shift 
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Appendix V^ 

Pseudo-Instructions 



The following table lists the available assembler pseudo-instructions with a short description of 
each, and the page number of the more detailed description listed elsewhere in this manual. 
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Instruction 


Form 


Description 


Page 


ANY 


Fihr-r 


SpeciOes a common or subroutine 
declaration to be any type 


112 


BSS 


BSS {expression} 


Reserves a block of memory 


56 


COM 


COM 


Preface for assembly language common 
declarations 


128 


DAT 


IJIIT {expression} [ ,, {expression} [, ...] ] 


Defines data generators 


57 


END 


END {name} 


Designates the end of a module 


17 


ENT 


EN! {symbol} [, {symbol} [,...]] 


Identifies entry points in the module 


77 


EQU 


EQU {expression} 


Defines a symbol 


71 


EXT 


ExT {symbol} [, {symbol} [,...] ] 


Identifies external entry points 


77 


FIL 


C" T \ 


Specifies a subroutine declaration to be a 
file number 


110 


HED 


HED {comment} 


Source listing control for top-of-page with 
change of heading 


64 


IFA 


IFFi 


■s 






IFB 


II-FB 








IFC 


T P" f "■ 








IFD 


IFD 








IFE 


IFE 




• Beginning of conditional assembly 


66 


IFF 


IFF 








IFG 


IFG 








IFH 


IFH 








IFF 


IFF' {numeric expression} 


■ 






INT 


INT [ (:+:) ] 


Specifies a common or subroutine 
declaration to be an integer 


110 


LIT 


LIT {expression} 


Reserve memory for literals and links 


74 


LST 


LST 


Source listing control for enabling the 
listing 


61 


NAM 


NflH {name} 


Designates the beginning of a module 


17 


REL 


REL [ (=i<)] 


Specifies a common or subroutine 
declaration to be full-precision 


110 


REP 


REP {expression} 


Repeats instructions 


59 


SHO 


SHO [ (*:) ] 


Specifies a common or subroutine 
declaration to be short-precision 


110 


SKP 


SKP 


Source listing control for top-of-page 


63 


SPC 


SPC {integer expression} 


Source listing control for printing blank 
lines 


65 


STR 


STR [ (:*)] 


Specifies a common or subroutine 
declaration to be a string 


110 


SUB 


SUB 


Preface for a subroutine entry point 


108 


UNL 


UNL 


Source listing control for disabling the 
listing 


61 


XIF 




End of a conditional-assembly block 


66 
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Appendix lJ 

Assembly Language 
BASIC Language Extensions 

Formal Syntax 



The following is an alphabetical list of the BASIC Language extensions provided by the Assem- 
bly Language ROMs. For a full discussion of their semantical meanings and applications, 
consult the indicated pages in this manual. 



Assembled Location (page 4) 

{symbol} [ , {BASIC numeric expression} ] 
{expression} [ , {BASIC numeric expression} ] 

where: 

{BASIC numeric expression} serves as a decimal offset from the given label or constant. 

{symbol} is an assembly location. It may be either a label for a particular machine instruc- 
tion (in which case the address of the associated instruction is used), or an assembler- 
defined symbol (in which case the associated absolute address is used), or a symbol 
defined by an EQU instruction (in which case the associated value is used). 

{expression} may be a numeric expression or a string expression. If numeric, a decimal 
calculation is performed and the result is interpreted as an octal value; if the result is not 
an octal representation or an integer, an error results. If a string expression is used, the 
string must be interpretable as either an octal integer constant or a known assembly 
symbol (see {symbol} above). 

DECIMAL Function (page 184) 

_, ( {BASIC ^numeric expression} ) 
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lADR Function (page 185) 

IFiDR: ( {assembled location} ) 
lASSEMBLE (pages 60-67) 

{module} [ = {module} [,...]][; {option} [, {option} [ , ...] ] ] 
" - - " " [. {option} [, {option} [ ,...]]] 

where {module} is the name of an existing module in the source program. 

{option} may be any of the following: 



{numeric expression} 
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IBREAK (pages 174-180) 



] {address} [ , {counter} ] [ 
-] {address} [ .. {counter} ] [ 
-" ] {address} [ , {counter} ] [ 
[ " -- {subprogram} ] 
[ -.\' ..\ {line identifier} ] 
[ ' ' {line identifier} ] 



{subprogram} ] 
. £ {line identifier} ] 
{line identifier} ] 



'i;V> 



erei 



{address} is an assembled location. 

{subprogram} is the name of a BASIC subprogram. 

{counter} is a numeric expression. 

{line identifier} is a line in the BASIC program. 



ICALL (pages 107-111) 



{routine} [ ( {data item} [ , {data item} [,...]] ) ] 



where {routine} is the label associated with a SUB pseudo-instruction sequence and {data 
item} takes on the same forms and attributes as parameters in BASIC'S CALL statement. 

ICHANGE (page 187) 



{assembled location} TO {octal expression} 



ICOM (pages 19-22) 



{integer constant} 



IDELETE (pages 22-23] 



{module} [ = {module} [ ,...]] 



where {module} is the name of an existing module in the ICOM region. 
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IDUMP (pages 181-183) 

I EH iMF--' {location} [ ;; {location} [::...]] 

where {location} has the following syntax: 

[ {mode selection} ] {address} [TO {address} ] 

with {address} an assembled location and {mode selection} taking on any of the 
following forms — 

FtSC for ASCII character representation 

B I N for binary representation 

DEC for decimal representation 

HE; < for hexadecimal representation 

OCT for octal representation 



ILOAD (page 22) 

{file specifier} 

where {file specifier} is of the same form as elsewhere in BASIC (see Mass Storage 
Techniques manual, or Operating and Programming manual). 

IMEM Function (page 186) 

irltlM ( {assembled location} ) 

INORMAL (page 179) 

[ {address} ] 
where {address} is an assembled location. 

IPAUSE OFF (page 174) 
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IPAUSE ON (pages 171-174) 



ISOURCE (pages 49-54) 

E. {source line} 

where {source line} may take either of the following forms — 

[ {label} ;; ] {action} [ ! {comment} ] 
[ {label} : ] ! {comment} 

and: 

{label} is of the same form as elsewhere in BASIC; 

{action} is a machine instruction, pseudo-instruction, or data generator; 

{comment} is any combination of characters 

ISTORE (pages 23-24) 

ISTOF::El {module} [ . {module} [,...]] ;; {file specifier} 
.1 5 T R: F, [ Fi L L...] ; {file specifier} 

where: 

{module} is the name of a module currently existing in the ICOM region. 

{file specifier} is of the same form as elsewhere in BASIC (see the Mass Storage 
Techniques manual or the Operating and Programming manual). 

LITERALS (pages 72-75) 

= {expression} [, {expression} [, ...] ] 
{expression} may be absolute or relocatable 

OCTAL Function (page 184) 

OCTRL ( {numeric expression} ) 
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Appendix £1 

Predefined Assembler Symbols 



The assembler has predefined a number of symbols and has reserved them as references to 
special locations in memory. Each of these locations has a special meaning and function. You 
may not redefine these symbols. They are — 



Name 




Description 


A 


Arithmetic accumulator 


Arl 
Ar2 


f BCD arithmetic accumulators 


B 


Arithmetic accumulator 


Base page 


Base page temporary area (50 words) 


C 


Stack pointer 


Cb 


Block bit for byte pointer in C(most significant bit of address 138) 


D 


Stack pointer 


Db 


Block bit for byte pointer in D(second most significant bit of address 138) 


Dmac 


DMA count register 


Dmama 


DMA memory address register 


Dmapa 


DMA peripheral register (lower 4 bits of address 138) 


End_isr high 






End_isr low 






Isr_flag 




■ Reserved symbols for use with interrupt service routines 


Isr_psw 






Oper_l 
Oper_2 


> Arithmetic utility operand address registers 


P 


Program counter 


Pa 


Peripheral address register (lower 4 bits of address ll8) 


R 


Return stack pointer 


R4 






R5 
R6 




• I/O registers 


R7 






Result 


Arithmetic utility result address register 


Se 


Shift-extend register 


Utlcount 


" 


Utlend 


■ Reserved symbols for writing utilities 


Utltemps 


- 





Each predefined symbol references a particular location in memory, except for the Utlend 
symbol, which refers to an ekecution address of a system routine. A graphical representation of 
these locations, plus others of interest, is presented on the next page. 
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address* 






CPU 
registers 


- starting address 


A 




B 




P 


37 


R 


40 


(reserved) 
(at least 17io words) 


R4 


min=41 


R5 




user data 
(ICOM area) 


dependent upon 
system needs 

\ Cb^ 


R6 
R7 




(reserved) 




1 :pa ; 




^ (reserved) 




1 1 Pm^pa 


77756 ^ 


-^ Dmama 


71111 




dependent upon 

starting address, 

and 

length of ICOM, 


Dmac 


C 


100000 




D 








(reserved) 




Ar2 




Se 


170665 




170666 






Return stack 




(reserved) 


170737 








170740 








(reserved) 






177617 








177620 








Base page 






177701 








177702 


Oper_1 




177703 


Oper_2 




177704 


Result 




177705 








(reserved) 






177767 








M1170 








Arl 






177773 








Mill A 








(reserved) 






Mini 









address 

1 
2 
3 
4 
5 
6 
7 
10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 
24 
25 



37 



* in octal representation 



Utility Name 


LDA with: 


LDB with: 


Exits 


Other 


Description 


Page 


Busy 


address of 
bit pattern 


address of 
parameter 


RETl 




Retrieves busy bits for a BASIC variable 


130 


Error exit 


error 
number 


N/A 


None — returns to 
BASIC 




Aborts execution of ICALL statement, 
setting an error number 


191 


Get bytes 


address of 
storage area 


address of 
parameter 


RETl 


Storage area consists of: 
1st word — starting byte 
2nd word — number of bytes to be 

transferred 
3rd word on — sufficient space 

for string 


Accesses substrings (or parts of arguments) 


119 


Get elem bytes 


address of 


address of 


RETl 


Array info obtained by Get info 


Same as "Get bytes" used for accessing elements 


120 




storage area 


array info 




utility. Relative element number 
must be stored in array pointer 
(word 16) of array info. 
Storage area same as in Get bytes. 


of string arrays 




Get file info 


address of 


file 


RET 2 — normal 


Storage area contents after return: 


Accesses a file-pointer 


164 




storage area 


number 


RET 1 — file unassigned 


word - lower 16 bits of file address 
word 1 - number of defined records 
word 2 — current record number 
word 3 — current word in current record 
word 4 - size of defined record 
word 5 - mass storage unit specifier 
word 6 — buffer address 
word 7 - check read (O = off, l=on) 
word 8 — high 7 bits of file address 
word 9 — (reserved by system) 






Get info 


address of 


address of 


RETl 


Storage area must be at least: 


Returns the characteristics of a variable 


114 




storage area 


array info 




3 words — simple variables 
18 words — arrays 
for arrays, add 3 words for each 64K 
bytes in your machine's memory 


passed as a parameter or existing in common 




Get element 


address of 


address of 


RETl 


Array info obtained by Get info 


Same as "Get value", used for elements in 


118 




storage area 


parameter 




utility. Relative element number 
must be stored in array pointer 
(word 16) of array info. 
Storage area must be sufficient 
size to hold value. 


an array 




Get value 


address of 
storage area 


address of 
parameter 


RETl 


Storage area must be sufficient 
size to hold value 


Returns the value of a BASIC variable 


117 


Int to rel 


N/A 


N/A 


RETl 


Load address of integer into 
Oper 1 and address of storage 
area into Result. Storage area 
must be at least 4 words. 


Data type conversion from 
integer to full-precision 


104 


Isr access 


address of 


select code 


RET 1 — linkage not 


select code is 0-7 for low-level or 8-15 for 


Establishes linkages for interrupts 


143 




ISR 


in bits 0-3; 
access 
code in 
bits 4-5; 
trial 

counter 
bits 8-14 


established for 
reason found in 
register A: 

- 1 = resources 

unobtainable 

- 2 = select code 

linked to 
another ISR 
RET 2 — normal 


high-level; resource code is: 

— no resources 

1 — asynchronous access 

2 — asynchronous access with DMA 

3 — synchronous access 

trial counter is number of attempts before 
aborting (RET 1, with A set to - 1) 






Mm read start 


address of 




RET 1 — memory overflow 


Mass storage descriptor is 3 words containing: 


Prepares to read a physical 


158 




mass storage 


N/A 


RET 2 — normal 


word 1 — mass storage unit specifier 


record from mass storage 






descriptor 




(A contai»>s mass 
storage transfer ID) 


word 2 — least significant 16 bits of record number 
word 3 — most significant 7 bits of record number 
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Utility Name 


LDA with: 


LDB with: 


Exits 


Other 


Description 


Page 


Mm read xfer 


mass storage 
transfer ID 


address of 
storage area 


RET 1 — transfer incomplete 
RET 2 — transfer complete 

(A contains 0, or 

error number encountered 

during transfer) 


Storage area must be at least 128 words 
Mass storage transfer ID would be returned 

from Mm read start utility. 
Storage area receives transferred information 


Reads a physical record from mass storage 


159 


Mm_write start 


address of 
mass storage 
descriptor 


address of 
storage area 


RET 1 — memory overflow 

RET 2 — normal 
(A contains mass 
storage transfer ID) 


Mass storage descriptor same as in Mm read start. 
Storage area must be at least 128 words and contain 
information to be transferred 


Writes a physical record to mass storage 


161 


Mm write test 


mass storage 
transfer ID 


N/A 


RET 1 — transfer incomplete 
RET 2 — transfer complete 
(A contains 0, or error 
number encountered 
during transfer) 


Mass storage transfer ID is returned from 
Mm write_start utility. 


Verifies a physical record was 
written to mass storage 


161 


Printer select 


select code 


printer 
width 


RETl 
(A contains previous 
printer select code; B 
contains previous printer 
width) 




Changes or interrogates select-code 
for standard printer 


166 


Print string 


address of 
string 


N/A 


RET 1 — memory overflow 
RET 2 1^121) pressed 
RET 3 — normal 


String must be in same form as standard string 


Outputs a string to the standard printer 


167 


Put_bytes 


address of 
storage area 


address of 
parameter 


RETl 


Storage area same as Get bytes 


Replaces substrings (or parts of arguments) 


124 


Put elem bytes 


address of 
storage area 


address of 
array info 


RETl 


Same as Get elem bytes 


Same as "Put bytes", used for accessing elements of 
string arrays 


125 


Put_element 


address of 
storage area 


address of 
array info 


RET 1 


Same as Get element 


Same as "Put value", used for elements in an array 


123 


Put_file_info 


address of 
storage area 


file 
number 


RET 1 — file unassigned 
RET 2 — normal 


Same as Get file info 


Manipulates a file-pointer 


165 


Put_value 


address of 
storage area 


address of 
parameter 


RETl 




Changes the value of a BASIC variable 


122 


Rel_math 


number of 
operands 


execution 
address 


RET 1 
(A contains 0, or an error 
number) 


Address of first operand into 
Oper_l and address of second operand 
into Oper_2. Address of result 
area into Result. Execution address 
is for the desired routine. 


Provides access to all the arithmetic routines 


99 


Rel_to_int 


N/A 


N/A 


Overflow bit may be set 


Address of the value to be 
converted should be stored 
in Oper_l, address of storage 
area of integer into Result 


Data type conversion from full-precision to integer 


102 


Rel_to_sho 


N/A 


N/A 




Address of the value to be 
converted should be stored in 
Oper_l; address of storage 
area for converted number 
should be stored in Result 


Data type conversion from full-precision to short 


103 


Sho_to rel 


N/A 


N/A 




Same as Rel to_sho 


Data type conversion from short-precision to full 


105 



Appendix k 

Utilities 
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Appendix \3 

Writing Utilities 



A utility, essentially, is a "special" assembly language subroutine. What makes it special is a set 
of instructions which keeps it from being displayed when a program is being stepped through 
using the CUE) key. This provides some manner of security for the code in the routine from the 
casual user. 

The following must be done to make a section of code into a utility — 
1. The entry point for the utility must consist of the instruction — 



2. Each exit point from the utility must consist of the following instructions — 

n (n may be any number, - 32 through + 31, depending upon the desired 
returning point) 



For example, here is a simple utility to increment a private counter — 






junt 
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It is not required that a utility actually be a subroutine. It may also be in-line code by replacing 
the RET with JMP *+2. By making a section of in-line code a utility, you can make your LhslJ 
actions in debugging simpler. If you already know what a section does and don't want to have 
to step through each instruction in that section each time it is encountered, you can make it into 
a utility as above. Then, whenever it is encountered, the section is stepped through as if it were 
a single statement. 

Utilities, and calls to utilities, are not allowed in interrupt service routines (ISRs). 
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Appendix 11 

I/O Sample Programs 



oE Cflf 





INTEi 


■iER Sel ec 


:t. i 


: OCJi:::' 








^ EflSIC vF 












i 1 '3 


INFti- 


■• -5EL.EC" 


Ci 


IDE ■ 


"0 HF 


HE 1 




Ui Sel pct code 












1 40 I 


■-I|:ji_.jt, 


LINPn- 


■ - 


JTRIi 


•iO if 


ijPT-T 


p 


'.Input. $ : RSk 












1513 




_ Out- put _ 

InBUt 


J^ 


oh: 


;.<Sel 


H-;;; X- C 


or;h 


:.,lnput.::i::) 












foS 


1 


I SOUF::CE 








NflM 


Ou-i 


put. qp-:o F:s 












22S6 




I SOURCE 


\....Y 


■ i i-.c::i 


,.'■■■ -■"-!'": 


!!■■■■ 


1 




■ ^-^'J'' 




TO 
UK 


■ 1. 6 i3 C 


:;;;::,:::'•-■ :..,.;::;^:^: 


3W 




ISOUFojE 
I SOURCE 


! \ 


..TR. 


iieteef; 


F-PFPOh 


F-'l 


1/3 S;ELi;;j::T i 


■■■"i-^^'-L 


_ 






i TO 14 > 


380 

400 
4 1 13 
420 




I SOURCE 


P:::. I 




- 


1 
















440 
450 
460 




illi 








HDH 

liDi-i 
SHM 
















43Q 




■[SOURCE 


Sc:: 






I....DF1 








- 






- 
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510 


I SOURCE Sc 


ok ; 


520 


I SOURCE 




530 


I SOURCE 




540 


I SOURCE 




550 


I SOURCE 




560 


I SOURCE 




570 


I SOURCE 




580 


I SOURCE 
I SOURCE 
ISOURCE Wr 
I SOURCE 




600 
610 


tejioc 


620 


ISOURCE 




630 


ISOURCE 




640 


ISOURCE IJoi 


It;::' « 


650 


ISOURCE 




€60 


ISOURCE 




670 
680 


ISOURCE 
ISOURCE 




680 


ISOURCE ! 




700 


ISOURCE ! : 


:;1J;rP0U" 


710 

"7 '"]' CM 


ISOURCE ! 
Tcni ic=r-c' i 


CHFlF 


i cikJ 


.1 0-'...!i...'i '•.!.„• C ■ 

ISOURCE Wr 


te bvi 


740 
750 
760 

780 


ISOURCE 
ISOURCE 
ISOURCE 
ISOURCE 
ISOURCE i 




780 


ISOURCE Caj 


'd LJOWl- 



i....DB ™Parn-i_ St. 
LDfl =St.ri 



WEi 


fl,I 




Ds:; 


Str 


■n5 ■ 


..." 

LIJF 


MP i..ii 


'■ '' '^■- -;...... ^ 


jsr 

LDF 


Wri- 
=L.f 


.e_...but. 



"HEH THE 



3 GET 



■IN 



■■■■lEi''-i I i...^Hii!* 






•■Tpp T c; pi 






UrlKif, 
DOWf--i 



'lURCF 



RET 
LDH 






;flR; 
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JRC 



:;|-:ir j 









C£. 
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:;RUF-'T T 









Ifay CHFiRFlCTER 



Ji30 


T 


■iTEr;;E 


■^ oe 1 


Pr t. .- :~ 


1 1 


i: 


HSSEM 


rM....i::. 




\m 


I 




•••iFl.JT 
•■■1 IHT 


^'SELE 
#Se1 


ec t c o 




u. 


:ji...ri:. : 


LIHF 


UT ^"3T 


160 


1. 


JFILI. 


ji..-ii:. jCii 


i:_gpio 


161 


1 


TC-D T 






iSiS 


T 


•^^I+l 







■iOLlJ THE 



TE TO?" 






END 









JRCE 



jT cor 



^de 



...IRCE 






r "; ! i 


:;Er HERE i-mHEN I;5R OUTFiJT 1:5 


JMPLETE 


. . :;;:;o repeat 


io int. 




, Error i 


■xi%. Isr access 




f:esers^t:d to huld :E;elect r:n]:i 




RESERVED FOR 168 CHAR STRIH 




TEMP FOiJ'^isR 




T-fTh-jp piji? ;[::::;j:;:; 




equates; for cr.-l.f 




98032 INTERRUPT ENABLE MflSK 


I \-\G i"- OlJ 


..OWED EV CR.-LF TO fl GPIO i....IKE 



yjHi 



POSSIBLE 



:iER i..:UN ! i'"i I ! 



OK 



J.ut. 



DOJ 



OUF: 



Dli 



i ' 


i ■'.".' 


":F 




..iR 
ip 


~p C;.- 




M 


J L i 




M 


"p 



^bE IF Un!'':;.lJ J 
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! uF'EHlRTlLi! 


ic "r' 






! HNI) IHIT 




- 




i sFT iJF' Tl 


■IE EYl" 






i Sij I CRN 


GET Fi 








DflTH 




- 


i DO i-iHi-.iriSr 


■iRKE 






! re:;;;:hve w 


■TE PO 


-- ~ 




! SEE IF rii 


J^E 






! IF HOT, ■ 


"HEN E 


- 


- .- 



SOUROF 



SOURCE 



LnR 


Pa, 




! IJEPEHDIHG ON WHETHER 


THF 




RDH 


=~B 




! SELECT CODE IS HIGH, 


OR Li 


iw 


Tf.-iD 


..J.. ^ ..^ 


J^-^":...;^OU:, 


I ! ROUTINE 


iinht: 






E i"' i'"l 


■j sr h i rW' 


,1 






Llifl 


h'-HiL 




! RHD NOW TRIGGER RN E 


-iD OF 




RDH 


=■■-1 




! LINE ERRNCH= TO DO 1\ 


HIS. ■• 


"!■! 


I OR: 


Sbl 


1 


i CORRECT riflSK WORD MU: 


iT BE 




LDE 


= 1 
H 




! CflLCULHThD EY Ri COMPi 
! SHIFT INSTRUCTION 


JTED 




cTi:> 


Eol_ 




! ShvE THIS MRSK 

i HND. USE MflGIC CODE Ti 


-| 




LDR 


= 10 


;::E 


i TRIGGER THE EOL ERRNi 


::H 
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■•Pi i 



! THIS PROGRHM INPUTS fl STRING USING INTERRUPT FROM fl GPIO-LIKE INTERFRCE. 
I 

! INTERF'flCE CARDS flPPLICRELE flRE^ 



40 

60 
70 
80 
90 

100 
110 

120 

140 

160 
170 

1 SQ 

200 

210 
230 



! 9o032 16 BIT PflRFiLLEL 

i 98033 BCD 

! 98036 SERIAL INTERFACE (INTERRUPT ENABLE BYTE SHOULD BE CHANGED 



ALLON FOR 166 CHARACTEK STRINb 

BASIC VARIABLE TO HOLD THE SELECT CODE 



i 

I COM 1000 

DIM Input $[160] 

INTEGER Select_code 

I ASSEMBLE 

INPUT "SELECT CODE TO READ FROM? % Sel ect.__ code 

ON INT #Se1ect___code GOTO Isr^done' I SET UP END OF LINE BRANCH 

ICALL Enter qpio int (Select code) ! START THE READ OPERATION 



ICflLL Rea.dj-esu 1 1 ( I nput * ) 
DISP "PARTIAL RESULT=" ; Input$ 
GOTO 170 
I 

I sr_done : ICALL Re-ad__resu 1 1 ( I nput ■$ ) 
DISP " INPUT COMPLETE^ . .STRING="; Input* 
!_.r-iii 



WHILE NRITIHG FOR IT TO COMPLETE, 
DISPLAY THE PARTIAL RESULTS 



290 

300 

310 

330 
340 
350 
360 



I SOURCE NAM Enter qpi Ci__i nt 

OURCE Strinq^ ESS 81 
OURCE Byte pointer" BSS 1 
I SOURCE Eo!_mask:; ESS 1 

I SOURCE Or; EGiU 13 

I SOURCE Enab!6__!ih=isk:EQU 200E i 98 

I SOURCE ! 

I SOURCE ! ROUTINES TO INPUT A STRING FOLLOWE 

I SOURCE i INTERFACE USING INTERRUPT= 

lOijL'KCE * 

ISOURCE ! ENTF^iY F'OINT:; Enter qpio int 

ISijL5F:!UE 1 

1) INTEGER CONTAINING SELECT CODE ( 1 TO 1 

RS^ 19 SELECT CODE OUT OF RANGE 
XOM" !,_■ rir-, J_- ur^. r ti.r*. .lee ~tii~.it i i-'=™*i'*:Ei 



■=t i ue , Err cu-"- __e>:: 1 1 , 1 s-r~-__ .ac c e:=-s 
\ RESERVED TO HOLD SELECT CODE 
■ R'E'E'ERVED FOF? 160 OHAR' fiTRIf-iG 
I BYTE POINTER FOR ISR 

! EQUATES FOR CR--1..F 



INTERRUPT ENABLE MAS!- 



410 
.■1 or-i 


T C'" i iDE~C' 


^ parameter: 

[ 


•T CL ti 

430 


ISOURCE 


i POSSIBLE E 


440 


ISOURCE 


! 


450 


ISOURCE 


1 


460 


ISOURCE 


! ENTRY POIr- 


470 


ISOURCE 


\ 


480 


ISOURCE 


i PARAMETER:: 


490 


ISOURCE 


! 


500 


ISOURCE 




510 


ISOURCE 


Parrsi sc : 


528 


ISOURCE 


Enter qpio i 


530 


ISOURCE 




540 


ISOURCE 




Er. cr rii 


ISOURCE 




560 


ISOURCE 




570 


ISOURCE 




5:30 


ISOURCE 








UN THE 



■■de i GET mE SE 



CHECK FOR VALID RANGE (1-1 



IDA =-1^ 



.^KL-t ic errEjr 



;;M Err 
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63 fi 


I SOURCE :~ 


640 


I SOURCE 


650 


I SOURCE 


6€S 


I SOURCE 


670 


I SOURCE 


630 


ISOURCE 


690 


I SOURCE 


700 


ISOURCE 


710 


ISOURCE 


720 


ISOURCE 


730 


ISOURCE 


740 


ISOURCE 


750 


ISOURCE 


760 


ISOURCE 


770 


ISOURCE 


780 


ISOURCE 


790 


ISOURCE 


800 


ISOURCE 


810 


ISOURCE 


820 


ISOURCE 


830 


ISOURCE ! 


840 


ISOURCE C 


350 


ISOURCE 


860 


ISOURCE ! 


870 


ISOURCE 


380 


ISOURCE F 


390 


ISOURCE F 


900 


ISOURCE 


910 


ISOURCE 


920 


ISOURCE 


930 


ISOURCE ! 


940 


ISOURCE I 


950 


ISOURCE 


960 


ISOURCE 


970 


ISOURCE 


980 


ISOURCE 


990 


ISOURCE 


1000 


ISOURCE 


1010 


ISOURCE 


1020 


ISOURCE ■ 


1030 


ISOURCE 


1040 


ISOURCE 


1050 


ISOURCE 


1060 


ISOURCE 


1070 


ISOURCE 


1080 


ISOURCE 


1090 


I SOURCE 


1100 


ISOURCE 


1110 


ISOURCE 


1120 


ISOURCE 


1130 


ISOURCE 


1140 


ISOURCE I 


1150 


ISOURCE 


1160 


ISOURCE ! 


1170 


ISOURCE T 


1180 


ISOURCE 


1 1 90 


ISOURCE 


1200 


ISOURCE 


1210 


ISOURCE 


1220 


ISOURCE 


1230 


ISOURCE 


1240 


ISOURCE 



LDB =< 10*256 >-Kl - 

Jf,ip 3,;;""q|< 

LDFi =0 

STh String 

LBfl ^String 

oHL, 1 

RDR =1 

S T fl B 'y' t e points- r ■ 

[ TiPi p4 



dowi- 



LDfl -Enabi€_ 


rnash 


STfl R5 




RET 1 




LDR =164 




JSM Error e>: 


it 



LDfl 


35 B 


STfl 


S-id.'-.-' 


Llifl 


34B 


STfl 


35 E 


LDfl 
STfl 


c 




R4 




• Do 


1 r- . . 


=Lf 


T'.if 


' Ti=- 






LDfl String 
J MP Termir 



LDfl 


Pa. 


ADA 


= — 


on.r 
JSM 


En 


JMP 


■s-H- 



SEE IF CARD IS OK 

FIRST COPY SELECT CODE T( 

SKIP IF DOWN 



[F COUL.DH'''T LsET IT, RETR' 

n'RING BUFFER flREfl 

JET UP BYTE POINTER FOR : 



r u i 






wflr 



! EHflELE 



■IR 



STRII 



OHERHT I i 






SO I iJflN PUT H Dh 



NTF 






■iHVE WE RECEIVED 



! DISABLE THE CARD 






! DEPENDING ON WHE". 


HER 


THE 


i SELECT CODE IS HI 


GH, 


OR LOW 


! CALL THE CORRECT 


TER 


n I NAT I OH 



qn, 1 
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1256 


i SOURCE 


1 260 


I SOURCE 


1270 


I SOURCE 


1280 


I SOURCE 


1290 


I SOURCE 


1300 


I SOURCE 


1310 


I SOURCE 


1 320 


I SOURCE 


1330 


I SOURCE 


1340 


I SOURCE 


1350 


1 SOURCE 


1360 


I SOURCE 


1370 


1 SOURCE 


1380 


I SOURCE 


1380 


I SOURCE 


1400 


I SOURCE 


1410 


I SOURCE 


1420 


I SOURCE 


1430 


I SOURCE 


1440 


I SOURCE 


1450 


I SOURCE 


1460 


I SOURCE 






HilH 


= ■■•■• 


I OR 


= 1 


EXE 
o T B 


H 
Eo 


LDE 


J. s 


C" "j" Q 


™ 1 


RDE 


::=3 


LjjF! 


Eo 



:U I 



STfl I: 

STfl 3'. 
SEL 1 



FlHD r-^OW IRl 


GiTER FlH EHIJ Or- 


LINE ERFlHCh 


-. TO DO THIS, T 


CORRECT Mfl::; 


!•■; UijRD nUF;l" BE 


::!bE:'f-^!^"'I5:.. 


EV fl COMF^UTED 


SfiVE THIS r 


IJl: i j, ijH 


Hi-iD USt riFlG 


IC CODE TO 


TRIGGER THE 


EOL :BRFii--ii::H 





■ RESTOFs;e ■:v5 




1 RETURN FT;;0H IHTERRi 




i BIT rIflSK F'OF:: IHSTFI 


fo int. 
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10 



P'P'I T Th I 



DIM Input $[ 160] 



110 



iHbstriBLE 

120 OH IHT #Si 

140 Input: LII 
150 ICRLL Out I 



1 90 



JODE TO WRITE TO?" 



WRITE"^%Inp 



:H--' ' -I. 



ISP I 

=1+1 




UTO 1?L 


1 


OTO Inf 


>ut 


I St 
ISC 

ISr 


lURCE 
URGE 
iURCE i 



:hd of 

j-'ipL-i t. '±- ) 

I DO OTHER WORK WHILE IHTERRUF 



HHM 

• » bop 






jURi 



i PESB 


::\^^EIi TO 


HO 


...D SELE 


1 RESEi 


WEI! FO 


< 1 


S0 CHFif 


1 R£SEl 
1 -nrMj::. 

! TEMP 


FOR IS 


Ex 
F: 
R 


=HHIi S' 


i EQUR" 


"ES FijR 


OR 


-LF' 



;!!^M 



40U 
4 1 

430 
440 

460 
470 



b7y 



JURCE 



i-HiSK I t.h'X 

•iF Tfi ni 



^T" 



I SOURCE i 

I SOURCE I 

I SOURCE ! POSSIBLE EF 

I SOURCE ! 

I SOURCE i 

I SOURCE F-arrfi stn: STR 

ISuURCE nutput_gpi c^dma: LDH =Se i ect 

ISOUFlCE LDH Select code 

I SOURCE HliR =-1 

I SOURCE ShM Sc error 

xoUUkJ„-c. ■_"■"'?': wr"'r~"C=;'"' 'r"X "I 'C 

I SOURCE ! 









nt. -^'iz-i—ti 



-IjJ n PAi 



;HECF( FO 



! GIVE ERROR 19 IF SELEC 
! IS OUT OF RFlHGE 

! SEE IF CARD IS OK 



248 Appendix H: I/O Sample Programs 



£2'0 


I SOURCE 




LDH =164 


sm 


ISuUf?CE 




JSM Error_exii:. 


650 


ISOUFICE < 






66B 


I SOURCE Cs 


If- id ok: I 


LDR =lsr 


S70 


I SOURCE 




LDB = (10*256 >+<2*l6 


5 '30 


I SOURCE 




RDE Select.__code 


590 


I SOURCE 




JSM I SI- -acces:;;;. 


P00 

/10 


I:30URCE 
I SOURCE 




..JI-'IP Sr'""ok 
Llifl =String 


?'20 


I SOURCE 




Lli]:;; ==P.af-rri sir 


73B 


1 SOURCE 




JSri Get Malue 


740 


I SOURCE ! 


FTjR riMF 


i, THE NORIIRL STRING FO 


?50 


I SOURCE ! 


EE STOP 


ED ONE BYTE PER WORD, : 


760 


1 SOURCE i 


EXPHHIJ 


THE STRING FIND HDD R C 


7' 70 


I SOURCE 




LDH =St.rir!q+l 


780 


I SOURCE 




SflL 1 


7'90 


I SOURCE 




ADR String 


800 


I SOURCE 




RDH =--l 


810 


I SOURCE 




STfl C 


ci20 


I SOURCE 




CDL 


1330 


I SOURCE 




LDH =Strir!q+3 


840 


I SOURCE 




RDfl Strinq 


8!::i0 


I SOURCE 




STfl D 


360 


I SOURCE 




LDR =Lf 


370 


I SOURCE 




PWD fl,D 


880 


I SOURCE 




LDFi =Cr 


890 


I SOURCE 




PWD Hjli 


900 


I SOURCE 




LDE String 


910 


I SOURCE 




TCB 


920 


I SOURCE 




SIB *-i-4 


9:30 


I SOURCE 




NBC H,D 


940 


I SOURCE 




PND fl,D 


950 


I SOURCE 




RIE *-~2 


960 


ISOURCE 




LDH Strinq 


970 


I SOURCE 




mft "1 


9801 


ISOURCE 




STfl Dinar 


990 


ISOURCE 




LDfl =String+i 


1000 


ISOURCE 




STfl Drri.B.rM.3. 


1010 


ISOURCE 




SDO 


1020 


ISOURCE 




LDfl =^Enable mask 


1030 


ISOURCE 




STfl R5 


1040 


ISOU!^;C:E 




DMA 


1 050 


ISOURCE 




RET 1 


1 060 


ISOURCE ! 






1070 


ISOURCE I 


j:.r- : 


LDH 35 E 


1080 


ISOURCE 




STfl SaueSS 


1090 


ISOURCE 




LDfl 34B 


1100 


ISOURCE 




STfl 35B 


1110 


ISOURCE 




LDH =0 


1120 


ISOURCE 




STfl R5 


1130 


ISOURCE 




DDR 


1140 


ISOURCE 




LDfl F'a 


1150 


ISOURCE 




flDfl =-8 


1160 


ISOURCE 




SAP *+3 


1170 


ISOURCE 




JSM End isr low, I 


1180 


ISOURCE 




JNP *+2 


1190 


ISOURCE 




JSM End isr high, I 


1200 


ISOURCE 




LDfl Pa 


1210 


ISOURCE 




flDfl ="1 


1220 


ISOURCE 




I OR Sb1 1 


1230 


ISOURCE 




LDE =1 


1240 


ISOURCE 




EXE fl 



GIVE ERROR 164 



SET UP AN l:3F: 

1 TR I ES , RESOURCE =2==DNfl 



:f couldn-t get it, retr 

HET THE STRING PflRflMETER 



iflT WON'T D0= THE DflTfl MUST 
THE FOLLOWING LOOP WILL 

LP 
FIRST SET UP BYTE POINTER TO 
WITHDRflW THE LflST CHflRflCTER 
FIRST 

! USE C FOR THE BYTE POINTER 

! NOW COMPUTE A WORD POINTER 
! TiJ WHERE TO PLACE H-IE LP 

! MO''/E Ii--i fl L.F 

! AND CR 

! f-iOW LOOP TO COF'Y iiLL E'l'TES 



! SET UP DMA CONTROL ' REGISTERS 

i COUNT = #CHflRS-l 

! DMflfl = DflTfl ADDRESS 

! SET DMA OUTWARDS 

! ENABLE THE CARD TO INTERRUPT 



! GO BACK TO BASIC. 

! I WILL GET THE INTERRUPT 

! THE DMA TRANSFER IS COMPLETE 



! SO DISABLE THE CflRD 

DISABLE DMA 

DEPENDING ON WHETHER THE 

SELECT CODE IS HIGH, OR LOW 

CALL THE CORRECT TERMINATION 

ROUTINE 



AND NOW TRIGGER flN END OF 
LINE BRflNCH. TO DO THIS, THE 
CORRECT MflSK WORD MUST BE 
CALCULflTED BY fl COMPUTED 
SHIFT INSTRUCTION 
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1250 
1260 
1270 

1 290 

1310 
1320 
1330 
1340 
1350 
1360 
1 370 

1 390 

1 400 

1410 



IS 


OLIRC 


1£ 


OURC 


IS 


OURC 


IS 


OURC 


I? 


OURC 


IS 


OURC 


IS 


OURC 


IS 


OURC 


IS 


OURC 


IS 


OURC 


IS 


OURC 


IS 


OURC 


IS 


OURC 


IS 


OURf: 


IS 


OURC 


IS 


OURC 


IS 


OURC 



;:bll 



STB 


Eol mask 


LDB 


Isr psw 


LliR 


= 103B 


3Tfl 


E,I 


HUE 


=3 


LDH 


Eol mask 


DIR 




I OR 


E, I 


STfl 


E, I 


EIR 




STR 


Isr__f lag,I 


LDR 


Sa'v'e35 


STfl 


35 B 


RET 


1 


SBL 


1 



! SAVE THIS MASK 

! flND USE MRGIC CODE TO 

! TRIGGER THE EOL BRRHCH 



! RESTORE 35 

! RETURN FROM INTERRUPT 
! BIT HhSK FOR INSTRUCT I Of 



END Output gpio dn 
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■ITERF-'flCE CfiF'::D- 



:ING U 
F hRF 









iHi: 
IK 



150 



I COM 1000 
DIM input.*LliS0 
INTEGER Stiect 
INTEGER Ci-anar' 
INTEGER R, C 



! RLLOW FOR liSO CHhRhCTER STRINb 
! VHRIRELE to hold input CHRRhCTEiR 



CODE 



jN INT #Select.__code GOTO Isr;__done' I SbfTlp END OF LINE BRAN 
INPUT "NUMBER OF CHflRRCTERS TO RERD?'% Character count 



ICRLL Enter qpio cima 



'acter count 



"•t"rF|RX Tl-fE F^'E 



190 
200 
21 



ICRLL Test dma(C,fl> 

D I SP " DMR 'C0UNT= ^^ ; C , " RDDRE 

I = 141 



I ! HDDRESS 



240 
260 



° ICRLL Reiid resu 1 1 ( Inputs) 
INPUT COMPLETE. » . STRING:^'- ? Input* 



;ode:B:; 



I SOURCE 




I SOURCE 




I SOURCE 


Sel ect 


I SOURCE 


String" 


I SOURCE 




I SOURCE 
I SOURCE 


Eol_ jiias^ 


I SOURCE 


Enable 


I SOURCE 




I SOURCE 


! ROUT I 


I SOURCE 


! INTER 


I SOURCE 




I SOURCE 


! ENTRY 


I SOURCE 




I SOURCE 
T c-rii jDi~ir 


1 pRRRM 


i::-iJ'Jr:.L-l::. 

I SOURCE 





iS 1 



QfC:cp',yj::T: ji 

TEMP FOR I; 



SELEC 
SDED 



i.DE 



0E 






i^ELECT CODE 
S TO FSEFLiJ ( 



4 CFiRD OR F^'E^hllFH-IERRL DOF 



I SOURCE ! PRRf 
I SOURCE i 






i40 



E'i ER : 1 > 









•IE SELECT CODE PRR 



W I TH 



Appendix H: I/O Sample Programs 251 



-lECK FUK VALID h;FlNGE <1-14 



vE ERROR 19 IF 
fliJT f\F RhKIGE 



ODE 



SOURCE 
>UL1RCE 
:5iJl.iRr:E: 



;:e 



leOid 


I SOURCE 


1910 


ISnURCE 


1020 


I SOURCE 


1030 


1 SOURCE 


1040 


1 SOURCE 


1050 


I SOURCE 


1 060 


I SOURCE 


1070 


I SOURCE 


1080 


I SOURCE 


1090 


I SOURCE 



;:Cf- 









cnuNi rHKflr 



JFihlGF 



■IRST COPY SELECT C( 
:LSE GIVE ERROR 164 



• i O .■' : J. 



JSri I: 



HDf 



jsn Put 



A- i....UUL..Uii 

NITIfiLIZE 






ENhELE THE 



T OF'FRi-T] 

TO INTEF 

i---OR DriF 



J Bl 



1110 



1 160 
1 170 

1 1 90 






"i-E r.=ir 



;;et 1 






TES PbN: 
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1250 


I SOURCE 


1260 


I SOURCE 


1270 


I SOURCE 


1230 


I SOURCE 


1290 


I SOURCE 


1300 


I SOURCE 


1310 


I SOURCE 


1320 


I SOURCE 


1330 


I SOURCE 


1340 


I SOURCE 


1350 


I SOURCE 


1360 


I SOURCE 


1370 


I SOURCE 


1380 


I SOURCE 


1390 


1 SOURCE 


1400 


I SOURCE 


1410 


I SOURCE 


1 420 


I SOURCE 


1430 


I SOURCE 


1440 


I SOURCE 


1450 


I SOURCE 


1460 


I SOURCE 


1470 


I SOURCE 


1430 


I SOURCE 


1490 


I SOURCE 


1500 


I SOURCE 


1510 


I SOURCE 


1520 


I SOURCE 


1530 


I SOURCE 


1540 


I SOURCE 


1550 


I SOURCE 


1560 


I SOURCE 


1570 


I SOURCE 


15S0 


I SOURCE 


1590 


I SOURCE 


1600 


I SOURCE 


1610 


j: SOURCE 


1620 


I SOURCE 


1630 


I SOURCE 


1640 


I SOURCE 


1650 


I SOURCE 


1 660 


I SOURCE 


1670 


I SOURCE 


1680 


I SOURCE 


1690 


I SOURCE 


1700 


I SOURCE 


1710 


I SOURCE 


17' 20 


I SOURCE 


1730 


I SOURCE 


1740 


I SOURCE 


1750 


I SOURCE 


1760 


I SOURCE 


1770 


I SOURCE 



FH C 



LDfl 
TCfl 
SIR 
WWD 

RIH 
LliH 
LDE 

RET 

LDfl 
STH 

i Tip 

STfl 
LDfl 
FlDR 

flDfi 
STfl 
LDfl 
STfl 
DDR 
LDfl 
flDH 
SAP 
JSM 
JMP 

jsn 

LDfl 
flDft 
I OR 
LDE 
'"•■■•IE 

LDE 
LDfl 
STfl 
flDB 
LDfl 
DIR 

EIR 
STfl 
LDfl 
STfl 
RET 
SBL 



String 



^String 
=RariVj_str 
Put^Mal ue 
1 



34B 

Drri-iic 
= 1 

String 

= 

pp. 



En^d__i£r_loi...i, I 

■*-^2 

End i2.r_hi gh, I 

r"i_ 

Sbl 1 
= 1 



-=.!•■■ 



;.r Pi 



Eol_ 

v.- T 



t 4-~iq, 



>-3. '-.■'€•■ 

■iflB 



! LET CHflRflCTER COUNT 



! GET fl BYTE 
! PflCK IT 

! RETURN RESULT TO EflS: 



! I WILL GET AN INTERRUPT WHEN 
! THE DMA IS COMPLETE 



I GET TO HERE WHEN DMA DONE 
JOMPUTE ACTUAL NUMBER OF 
:HARflCTERS TRflNSFERED 

! SAVE IN STRING LENGTH WORD 
! DISABLE THE CARD 

DISABLE DMA 

DEPENDING ON WHETHER THE 

SELECT CODE IS HIGH, OR LOW 

CALL THE CORRECT TERMINATION 

ROUTINE 



! AND NOW TRIGGER AN END OF 
LINE BRANCH. TO DO THIS, THE 
CORRECT MASK WORD MUST BE 
CALCULATED BY fl COMPUTED 
SHIFT INSTRUCTION 
SAVE THIS MASK 
AND USE MAGIC CODE TO 
TRIGGER THE EOL BRANCH 



RETURN FROM INTERRUPT 
BIT MASK FOR INSTRUCTION 
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10 

20 
:30 
40 



80 
90 

1 00 
110 

120 
130 
140 
150 
1 60 
17-0 
180 

1S0 
200 

210 

230 
240 

260 
270 
280 
290 

300 

310 
320 
330 
340 
350 
360 
370 
380 
390 

400 

410 
420 

4-.:'y 

44y 

46m 
470 



500 

510 

530 
540 
550 



5y0 

600 

610 



! 98034H HP IB ChRD BRIVEF? 

TWO RSSE::MELY LRHGUl-iGE DRIVERS RRE PROVIDEIi:: „ . ONE FOR OUTPUT HHD ONE 
FOR INPUT:, BOTH HAVE PROVISIONS FOR IHCLUDING fl BUS COHMRHD STRING 
FOR HBDRESSING THE BUS.. 



I C F^!.... L H p i b ou t fj u t 
ICRLL Hpib entisr 



;:C:MD*>, i: <BfiTR*> 
:;CMD$>, i: <VRR$> ] 



<ISC> "«= IHTERF'flCE SELECT CODE '-.l TO 14) <InTEGE!!R) 

<CP1D*> ::= STRING TO OUTPUT WITH RTN TRUE 

<BRTR*> ::=::: STRING TO OUTPUT WITH RTN FRLSE 

<VflR$> ::= STRING VRRIRBLE TO HOLD BRTR RERB FROM BUS 

iSIELE ERRORS: 

[64 CRRB WRS NOT RN HPIE CRRB 

::i00 <CMD:J:> [..ips hoh-NULL BUT THE CRRB WRS NOT RCTIVE CONTROLLER 

301 <BRTfl*> WHS NON--NULL BUT THE CRRB WRS NOT RCTIVER TRLKER 

:i02 <VRR*> WHS SPECIFIEB BUT THE CRRB WRS NOT RCTIVE LISTENER 



a.$i 160], Va.!-$C 1603 



icon 1000 

INTEGER Seieci 

BIM Crrid$Ll60J, 

iRSSEtlBLE 

INFIJT "HPIB SELECT COBE?" , Sel ect code 

ON KEY #0 GOSUB Outpi...it. 

PRINT "KEV0 = OUTPUT KEVl = ENTER" 

BISP "IBLE" 

GOTO :320 
Output;; GOSUB L input cmd 

LINPUT "BRTR TO SENB"'?" , Bata* 

ICRLL Hpi b output (Sel ect code, Cmd$. Bata.*: 

PRINT " "■■■■ BRTR SENT =='" ; Data* 

RETURN 
Enter" GOSUB Linput j:md 

ICRLL Hpib enter (Sel ect code, Crndl-, Var$> 

PRINT " """■ BHTH RERB =";Var* 

RETURN 



Linput c 
RETURN 



I SOUR 
ISOURC 
ISOURi 
ISOURC 

ISOURt 

ISOURC 

ISOURi 

ISOURC 

ISOUR( 

ISOURi 
ISOURi 
ISOURi 
ISOURC 



E 
E 

E Ci 
E Ik 



NHM Hpi 
EXT Get 

p.QC- O -j 

EQU Cffid 



E Parrii_ptr: ESS 1 

E Lf: EQU 11 

E Or: EQU l: 

E Status!: ESS 1 

E ! 

E uut_ica.rrn: bUE 

E . INT 



^!d$ 



ue, Put_ v-B.] ue, Error'__exi t 

! STRING TO HOLD CMD BYTES 

i STRING TO HOLE BRTR BYTES 

! INTERFRCE SELECT CODE 

! POINTER TO PRRM PSEUDO OP: 

! 4 WORBS TO CONTfilN STATUS 

! BY'TEo rFiUM 9'-'y-~'4 



254 Appendix H: I/O Sample Programs 



fe-^H 


.1. :::'UiJr.L-t r 


_c:iaT.a.: 


::::■ \ K 


640 


I SOURCE H 


pib_ out 


out I LDB =ijut 


650 


I SOURCE 




JSM Hpib : 


660 


I SOURCE 




UjFi Out. p. 


670 


I SOURCE 




CF-'H =2: 


680 


I SOURCE H 


J CiUtpU 


i:. = RET i 


690 


I SOURCE 




LDH ^Data 


700 

710 


I SOURCE 
I SOURCE 




.JSM Get.__y. 


720 


I SOURCE 




LDR Data 


730 


I SOURCE 




SZH i-kj ou 


740 


I SOURCE 




JSM Hpib 


~7^'Ck 


I SOURCE 




LDfi Statu 


760 


I SOURCE 




HMD :=40E 


"y'7fi 


I SOURCE 




RZR *+3 


""•' ■".' ("■ 


I SOURCE 




I....DR -^5131 


790 


I SOURCE 




.JSM Er-rci 


800 


ISOURCE 




LDH =Data 


810 


1 SOURCE 




::::;HL.. 1 



i y£S 



:0, DO MOT!- 






"E EVTE 



40 



: SOURCE 






.IMP ruit.. 



TE 



EE IF DON 



OURCE 


i 


OURCE 


Efvt_ 


ni iorcr 




ij'-'i':. !..■!::. 




OURCE 





ISOURCE 
ISOURCE 

ISOURCE 






H Pfli^RMETEF 



1018 


ISOURCE 


1 020 


ISOURCE 


■j OOiT-i 


T ■~:\"\\ ic:=*"""*ir 


J. ™ -...= *:_" 


.!. ■...= "„•=._':■-. ...■!__ 


1040 


ISOURCE 


1050 


ISOURCE 


1 060 


ISOURCE 


1070 


ISOURCE 


1080 


ISOURCE 


1090 


ISOURCE 


1100 


ISOURCE 


1110 


ISOURCE 


1120 


ISOURCE 


1130 


ISOURCE 


1140 


ISOURCE 
ISOURCE 


1160 
1170 


ISOURCE 
ISOURCE 


1180 


ISOURCE 


1190 


ISOURCE 



STH D-ata 
3RL i 



rpH =:Lt' 






ITER FOR Dfl" 



::CE 



-h.." -0" I.HfR 

'.-. ..T - ; ET>r- 
F rC, "iSOFE If 
.': :"■" TEF-"I-'hTO'- " 

UK- -•'''Pl--'l LE'-G^H 
?EPEfiT FOR NE;:<T EVTI 
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RETURN D 



"Ent 



lURCE ! 



C PRRRMETER RNIi OUTPUT 






ERRuf 



14913 
1 500 
1.510 






JRCE 



JRCiF 



T 


SOf 


IR 


;e 


I 


:E;ni 




jfc. 
:e 

JE 


I 


SOI 


JR 


:e 


I 


sen 


JR 


:e 


I 


SOi 


JR 


;e 


T 


301 


JR 


::E 


I 


50! 


JR 


:e 


I 


301 


JR 


::e 


1 


30^ 


JR 


:::E 



■•tr 






•alue 



•'■alue 






"OR 1 Ti: 



RDfl =-15+ 










C;Hpi .j.4.:3 










LDR :=:19 




•! ■!■ 


! IF 


OUT OF RANGE, GIVE E 


■J ■...■ ! i Ci 1 Ut 

LDH Se1ec- 


'■H' y- 


::ie 


! SET 


UP PR AND DO STATUS 


STR F'a 






i ON 


CARD TO VERIFY IT IS 


JSM Hpib 


2.tat 


i..iS 


i sat 


34R INTERFACE 


LDB Parrf! 


jt. f- 




! NOb 


FETCH COMMRNIi STRIN 


HJjH: =y 











—E-'" I i"" 1 Hi*" r'-'ti 1 ■'"■> Mf'-j v' ■ P 
L-UH i RULLEk 



..DR ■-=€ 






iSOUKCh 



>UURCt 
;;ni ippp 



SF 



isuurue 

I SOURCE 



i£l 






30URCE 
SOURCE 
50URCE 



I p| h" ! ! !"'4 L. '" M L, [ ^ K' I"'-! !~l ■ ■''.''!"* ill 

'■> HOWEVER COULD COM PR: i 






-Fli t. i rit:, 

[ST: 



iR I TniS ^"iEy LJb-HL'E 






DIR BEFORE THE LDA 
SYNCHRONUS I NTERFiUPT 
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lyfti 



1940 



I SOURCE 


TRfli- 


SFEF 


IN PF 


:0GRE:E;:E; 


A ■...■l..i •...': ■■.■.„••._ 

i: SOURCE i- 


pib_::;: 


tatt 


s:SFC 


"fr 


I SOURCE 






LlJfl 


R5 


I SOURCE 






HMD 


=6i;;i:Ei 


I SOURCE 






CPR 


==bi3E 


I SOURCE 






jni 


-' lirfS 


I SOURCE 






LIJH 


= 164 


I SOURCE 






JSil 


Error e 


T SOURCE 






SFC 


•s 


I SOURCE 






13 TR 




;l SOURCE 






SFC: 


•iir 


I SOURCE 






LIiH 


Rfc 


1 SOURCE 






SJh 


Status! 


I SOURCE 






SFC 


* 


I SOURCE 






III hi 


Rb 


I SOURCE 






STfl 


Statics 2 


I SOURCE 






SFC 


* 


I SOURCE 






Llifl 


P.G 


I SOURCE 






STFl 


StatusS 


I SOURCE 
I SOURCE 






SFC 
LDR 


■ir 


I SOURCE 






EIR 




I SOURCE 






::rrfl 


Status4 


I SOURCE 






RET 


i 


I SOURCE 






END 


Hpib 



FOR EKFlMPLE THE TAPE CnRTRIIiGE >, 

! GET THE CRRH INTO 

I TX--S STATUS SEQUENCE „ 

I MRKE SURE IT IS R 98034 



! IF HOT, GIVE ERROR 164 

! (THIS IS THE CRITICRL TIME 

! MADE IT, SO DISRELE MY 

! INTERRUPTS FOR THE REST Of 

! THE STATUS SEQUENCE. 
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10 ! PROGRfin TO DEMOHSTRflTE USING THE CLOCK FOR INTERRUPTS 

30 ! THIS EKflMPLE SHOWS HOW TO USE THE CLOCK INTERRUPT TO PUT THE TIME 

40 I OF DAY INTO THE SYSTEM MESSflGE AREA flS LONG flS THE PROGRAM IS RUNNING/ 

50 ! 

60 ! THE CLOCK IS PROGRAMMED TO GENERATE AN INTERRUPT EVERY SECOND. THE 

70 ! asSEMBLY INTERRUPT SERVICE ROUTINE TRIGGERS AH END OF LINE BRANCH. THE 

80 ! EOL BRANCH ROUTINE CALLS AN ASSEMBLY ROUTINE TO PUT THE TIME OF DAY 

90 ! INTO THE SYSTEM MESSAGE AREA. 



110 I COM 200 

icitJ i Aii'EMriLt. 

130 ICALL SetUiq_clQck I SET UP ISR AND START CLOCK 

140 ON INT #9 CALL Time ! SET UP EOL BRANCH 

■f Sis i 



160 


! BAf 


::KGROUND 


PROGRAM: 


170 


! 






180 


DISP 


T 




190 


1 = 1+1 






200 


GOTO 


180 




210 


j 






220 


SUB 1 


" i n-fc- 




230 


ICALL DispTa^ 


{_t i me 


240 


SUBE> 


aj 




250 




I SOURCE 




260 




ISOURCE 




270 




ISOURCE 




280 




ISOURCE 


Select c 


290 




ISOURCE 


EcA_ji-Ask 


300 




ISOURCE 




310 




ISOURCE 


Eol mask 


320 




ISOURCE 


Cr: 


330 




ISOURCE 


Lf: 


340 




ISOURCE 


String' 


350 




ISOURCE 


01d_pi : 


360 




ISOURCE 


Old pw: 


370 




ISOURCE 


1 


380 




ISOURCE 





NAM T i me 

EXT Err-or-___exi t. Printer- select, Print string 
EKT Isr access 
:EQU 9 " 

SET 1 ! GET ASSEMBLER TO COMPUTE 

REP Selectee ode ! THE EOL MASK FOR TRIGGERING 

SET Eo1___mask*2 I EOL BRANCHES 

EQU 13 ! OTHER EQUATES 
EQU 10 

BSS 20 ' \ AREA TO HOLD TIME OF DAY 

ESS 1 I TWO WORDS TO HOLD CURRENT 

BSS 1 ! PRINTER IS AND PRINTER WIDTH 

SUB 

390 ISOURCE Setup_c1ock:LDH =Se1 ect__cQde ! MAKE SURE THE CLOCK CARD 

400 ISOURCE STfl Pa ! IS ALIVE 
410 ISOURCE SSS Card_„ok 

420 ISOURCE Card_down: LDA =164 \ IF NOT, GIVE ERROR 164 
430 ISOURCE JSM Error^exit 

440 ISOURCE Card__ok: LDA =Isr ! SET UP ISR LINKAGE 
450 ISOURCE LDB =< 10*256 >+< 1*16 >+Se1 ect_code 
460 ISOURCE 'JSM Isr;_access 

470 ISOURCE JMP *-h2 ! IF ERROR, THEN JUMP 

480 ISOURCE JMP Start___card i ELSE GO START UP THE CARD 

490 ISOURCE CPA =-1 ! IF DIDN-'T GET RESOURCES 

500 ISOURCE JMP Setup_clock ! THEN TRY AGAIN 

510 ISOURCE RET 1 ! IF ISR ALREADY LINKED, RETURN 
520 ISOURCE Start_card: LDA =="U4H/U4=O4/U4P1000/U4G"+Lf 

530 ISOURCE SAL 1 ! SET UP C TO POINT TO STRING 

540 ISOURCE STA C ! WHICH I WILL OUTPUT TO THE 

550 ISOURCE CBL ! CLOCK TO PROGRAM IT. 

560 ISOURCE LDB =~21 ! B IS -(CHAR COUNT"! ) 

570 ISOURCE Out_loop: SFC * ! WAIT FOR CARD 

580 ISOURCE WEC R4, I ! SHOVE NEKT BYTE OUT TO CARD 

590 ISOURCE STA R7 ! TRIGGER HANDSHAKE 

600 ISOURCE RIB Out_l oop ! LOOP UNTIL DONE 

610 ISOURCE . LDA =200B i ENABLE THE CARD TO INTERRUPT 



258 Appendix H: I/O Sample Programs 



620 

630 



„ 



MURCE 
jUURCE 

;;nuRr:F 






I SOURCE 
I SOURCE 

I SOURCE 



-is iijh:'! ;[- 

SOURCE 
50URCE 
:iOURCE 

>OUF?CE 



T 



;:T INFHJT OPER 



HH'F 



JSM Print 


^■y ■=.!:::■] i=-r 


:. 


STfl Oid_p 


, 


! SAVE OLD 


S 1 .D U i d p 
LDR =Si:.'Fi 


-\g 


! DO THE PRINT 


JSM Print 


^string 




JMP Memo 
HOf"^ 


■•■' 


! JUMP IF. MEMORY 
! IGNORE STOP KEY 


Llifl Oldjo 




! RESET "PRINTER I 


LDE u]d"p 


,,,! 




JSM Print 


er sel EC 


:. 






lUPi 









i n 






t ?1H 



.iPr:F 
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Appendix 1 

Demonstration Cartridge 



Along with the Assembly Language Development and Execution ROMs, a tape cartridge has 
been provided to demonstrate the capabilities of the assembly language system. This 
Demonstration Cartridge (HP part number 11141-10154) is specifically intended to — 

• Graphically display the kind of speed increases which can be obtained by using assembly 
language subprograms for certain types of applications. 

• Provide a number of programs which can serve as examples of how to write assembly 
language subprograms.^ 

• Provide a set of definitions for some of the special function keys so that those keys can be 
used as typing aids. 

Using the Tape 

To run any of the demonstration programs, execute the statement — 



A set of instructions is displayed which can then be followed interactively. 

Typing Aids 

The starting and final cursor positions of the typing aids were chosen with assembly listings in 
mind. The intent in selecting these positions was to make it easy to enter source as it would 
appear when listed within an assembly listing. 

The following table gives, for each key; the typing aid, the position where the typing aid begins, 
and the position where the cursor will finally reside. Because some typing aids end with a blank, 
the triangle (A) has been chosen to indicate the end of the typing aid. All blanks after the start of 
the typing aid, and before the triangle, will appear when the key is pressed. 

1 The commented source for the chess program is contained in file CHESSS. 
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Typing Aid 


Final Cursor 


Key 


Typing Aid 


Starting Position 


Position 





A 


11 


31 


1 


A 


11 


19 


2 


A 


11 


21 


3 


X 
E 


home 




4 


i A 


current 


current + 2 


5 


T F'i 11 


,JF:CE A(followed by next line) 


11 


- 




! A 


51 


53 


6 


\umj -jt... ■ ■■ /\ 


home 


6 (over second quote mark 
in insert character mode) 


7 


/cleIm ■ - u A 

UlNEJ 1... ' . ■' Zi 


home 


7 (over second quote mark 
in insert character mode) 


8 


/cLEAr\ ii . 

IlineJ " A 


home 


7 (over second quote mark 
in insert character mode) 


9 


(^^ EBTOfRE '' "A 


home 


8 (over second quote mark 
in insert character mode) 


10 


/clEAr\ i: . 


home 


6 (over second quote mark 
in insert character mode) 


11 


(^^ bJ^..J r'-'i CH A 






12 


(used by other keys) 






13 


A(followed by next line) 


11 


- 




: A 


30 


32 


14 


(Undefined) 






15 


(Undefined) 






16 


(Undefined) 






17 


^ A 


41 


43 


18 


/CLEAm : -" ■,-■: r ■•-•■■ f •••■ r •-, » 

\line/ 1 O a 


home 


12 
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Key 



Typing Aid 



Typing Aid 
Starting Position 



Final Cursor 
Position 



19 

20 
21 

22 
23 
24 
25 
26 

27 
28 
29 
30 

31 



(use only after using Key 7 or 9) 



(use only after using key 7 or 9)' 



(used by other keys) 
(used by other keys) 



/clear\ 

I LINE I 



current — 1 



home 



current — 1 



current 
current 



home 

home 
home 
home 
home 

home 



current + 4 (over 
second quote mark in 
insert character mode) 

10 (over second quote mark 
in insert character mode) 

current + 4 (over second 
quote mark in insert 
character mode) 

current + 3 

current + 4 



18 (over second quote mark 
in insert character mode) 

13 



8 (over second quote mark 
in insert character mode) 

9 (over second quote mark 
in insert character mode) 



1 For example, in the insert character mode with the cursor in each case located over the second quote mark: 

• Pressing Key 7 results in — L OHU " 

• Pressing Key 19 results in — LORD E IN " 

2 This key performs for the keyword "KEY" as key 19 does for the keyword "BIN". See Note 1. 
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Appendix cJ 

Error Messages 



The following is a numerical list of the system error messages. A brief description of the error is 
given. For those errors involving the assembly language system, also consult Chapter 9. For all 
other errors, reference the Operating and Programming Manual. 

1 Missing ROM; or configuration error 

2 Memory overflow; or subprogram larger than block of memory 
Line not found or not in current program segment 

4 Improper return 

b Abnormal program termination; no END or STOP statement 

Improper FOR/ NEXT matching 

Undefined function or subroutine 

Improper parameter matching 

Improper number of parameters 

String value required 

Numeric value required 

Attempt to redeclare variable 

Array dimensions not specified 

Multiple OPTION BASE statement or OPTION BASE statement preceded by 
variable declarative statements 

Invalid bounds on array dimension or string length in memory allocation 
statement 

Dimensions are improper or inconsistent; or more than 32 767 elements in an 
array 

Subscript out of range 
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1 £i Substring out of range; or, string too long 

1 9 Improper value 

2 Integer precision overflow 
E 1 Short precision overflow 
2 2 Real precision overflow 

2 3 Intermediate result overflow 

24 TAN (7r*3/2), when n is odd 

2 5 Magnitude of argument of ASN or ACS is greater than 1 

2 G Zero raised to negative power 

2 7 Negative base raised to non-integer power 

2 8 LOG or LGT of negative number 
29 LOG or LGT of zero 

3 SQR of negative number 

3 1 Division by zero; or,X MOD Y with Y = 

3 2 String does not represent valid number; or string response when numeric data 
required 

3 3 Improper argument for NUM, CHR$, or RPT$ function 

3 4 Referenced line is not IMAGE statement 

3 5 Improper format string 

3 6 Out of DATA 

3 7 EDIT string longer than 160 characters 

3 8 I/O function not allowed 

3 9 Function subprogram not allowed 

4 Improper replace, delete, or REN command 
4 i First line number greater than second 

4 2 Attempt to replace or delete a busy line or subprogram 

H 3 Matrix not square 
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Illegal operand in matrix transpose or matrix multiply 

Nested keyboard entry statements 

No binary in memory for STORE BIN; or no program in memory for SAVE 

Subprogram COM declaration is not consistent with main program 

Recursion in single-line function 

Line specified in ON declaration not found 

File number less than 1 or greater than 10 

File not currently assigned 

Improper mass storage unit specifier 

Improper file name 

Duplicate file name 

Directory overflow 

File name is undefined 

Mass Storage ROM is missing 

Improper file type 

Physical or logical end-of-file found 

Physical or logical end-of-record round in random mode 

Defined-record size is too small for data item 

File is protected; or, wrong protect code specified 

The number of physical records is greater than 32 767 

Medium overflow (out of user storage space) 

Incorrect data type 

Excessive rejected tracks during a mass storage initialization 

Mass storage parameter less than or equal to 

Invalid line number in GET or LINK operation 

(See Mass Storage ROM errors) 
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liH 



Cartridge out; or door open 

Mass storage device failure 

Mass storage device not present 

Mass storage medium is write -protected 

Record not found 

Mass storage medium is not initialized 

Not a compatible tape cartridge 

Record address error; or, information can't be read 

Read data error 

Check read error 

Mass storage system error 

(See Mass Storage ROM errors) 

Item in PRINT USING list is string but IMAGE specifier is numeric 

Item in PRINT USING list is numeric but IMAGE specifier is string 

Numeric field specifier wider than printer width 

Item in PRINT USING list has no corresponding IMAGE specifier 

(See I/O ROM errors) 

(Unused) 

(See Plotter ROM errors) 

(Unused) 

(See I/O ROM errors) 

(Unused) 

(See Assembly Language ROM errors) 



{octal number} ; {octal number} 



This error indicates an error in the machine's firmware system; it is a fatal error. If reset 
does not bring control back, the machine must be turned off, then on again. If the problem 
persists, contact your Sales and Service Office. 
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Mass Storage ROM Errors 

Format switch off 

Not a disk interface 

Disk interface power off 

Incorrect controller address; or, controller power off 

Incorrect device type in mass storage unit specifier 

Drive missing; or power off 

Disk system error 

Incorrect unit code in mass storage unit specifier 

(Unused) 

(Unused) 

Plotter ROM Errors 

Plotter type specification not recognized 

Plotter has not been specified 

(Unused) 

LIMIT specifications out of range 

(Unused) 
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Assembly Language ROM Errors 

Improper argument in OCTAL or DECIMAL function 

Break Table overflow 

Undefined BASIC label or subprogram name used in IBREAK statement 

Attempt to write into protected memory; or, attempt to execute instruction not 
in ICOM region 

Label used in an assembled location not found 

Doubly-defined entry point or routine 

Missing ICOM statement 

Module not found 

Errors in assembly 

Attempt to move or delete module containing an active interrupt service 
routine 

Address out of range in IDUMP statement 

Routine not found 

Unsatisfied externals 

Missing COM statement 

BASIC'S common area does not correspond to assembly module requirements 

Insufficient number of BASIC COM items 
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Assembly-Time Errors 

DD Doubly-defined label 

EN END instruction missing; or module name does not match 

EX Expression evaluation error 

L T Literal pools full or out of range 

MO ICOM region overflow 

R!N Operand out of range 

SQ Argument declaration pseudo-instruction out of sequence 

T P Incorrect type of operand used 
Undefined symbol 
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Appendix l\ 

Maintenance 



Maintenance Agreements 



Service is an important factor when you buy Hewlett-Packard equipment. If you are to get 
maximum use from your equipment, it must be in good working order. An HP Maintenance 
Agreement is the best way to keep your equipment in optimum running condition. 

Consider these important advantages — 

• Fixed Cost — The cost is the same regardless of the number of calls, so it is a figure that 
you can budget. 

• Priority Service — Your Maintenance Agreement assures that you receive priority treat- 
ment, within an agreed-upon response time. 

• On-Site Service — There is no need to package your equipment and return it to HP. Fast 
and efficient modular replacement at your location saves you both time and money. 

• A Complete Package — A single charge covers labor, parts, and transportation. 

• Regular Maintenance — Periodic visits are included, per factory recommendations, to 
keep your equipment in optimum operating condition. 

• Individualized Agreements — Each Maintenance Agreement is tailored to support your 
equipment configuration and your requirements. 

After considering these advantages, we are sure you will see that a Maintenance Agreement is 
an important and cost-effective investment. 

For more information, please contact your local HP Sales and Service Office. A list follows. 



HEWLETT^ PACKARD 
SALES & SERVICE OFFICES 



< 

I- 



< 

< 

< 
o 

U. 
< 



ANGOLA 

Telectra 

Empresa Tricnica de 

Equlpamentos 

Elfctricos, S.A.R.L. 
R. Barbosa Rodrioues, 42-l°0T.° 
Caixa Postal, 6487 
Luanda 
Tel: 35515/6 
Cable: TELECTRA Luanda 

AUSTRALIA 

Hewlett-Packard Australia 

Pty. Ltd. 
31-41 Joseph Street 
Blackburn, Victoria 3130 
P.O. Box 36 

Doncatttr Eaat, Victoria 3109 
Tel: 896351 
Telex: 31-024 

Cable: HEWPARD MeKxiurne 
Hewlett-Packard Australia 

Pty. Ltd. 
31 Bridge Street 



New Soutti Wales, 2073 

Tel: 4496566 

Telex: 21561 

Cable: HEWPARD Sydney 

Hewlett-Packard AustraNa 

PW. Ltd. 
153 Greentiill Road 
Parksida, S.A., 5063 
Tel: 2725911 
Telex: 82536 

Cable: HEWPARD Adelaide 
Hewlett-Packard Australia 

Pty.Ltd. 
141 Stiriing Highway 
NadlaiKlt, W.A. 6009 
Tel: 3865455 
Telex: 93859 
Cable: HEWPARD Perth 
Hewlett-Packsd Australia 

Pty. Ltd. 
121 wollongong Street 
Fyahwick, A.C.T. 2609 
Tel: 804244 
Telex: 62650 

Cable: HEWPARD Canberra 
Hewlett Packard Ausftab 

PW. Ltd. 
5thnoor 

Teachers Union BuikJing 
495-499 Boundary Street 
Spring Hill, QuaanSbni 4000 
Tel: 2291 544 
CaUe: HEWPARD Briibtna 

BANGLADESH 

The General Electric Co. 

o( Bangladesh Ltd. 
Magnet House 72 
Dilkusha Commercial Araa 
MoUUmII, Dacca 2 
Tel: 252415, 252419 
Telex ' 734 
Cable': GECDAC Dacca 



ETHIOPU 

Abdella Abdulmaik 
P.O. 60x2635 
Addia Ababa 
Tel: 11 93 40 

GUAM 

Medical Only 

Guam Medical Sifpply, Inc. 

Suite C, Airport Pkua 

P.O. Box 8947 

Tamuning 96911 

Tel: 646-4513 

Cable: EARMED Guam 

HONGKONG 

Schmidt & Co.^ng Kong) Ltd. 

Wing On Centre, 28th Fkior 

Connaught Road, C. 

Hong Kong 

Tel:W556« 

Telex: 74766 SCHMCHX 

INDIA 

Blue Stv Ltd. 
Kasturi BulMings 
Jamshedp Tata Rd 
Boinb«400 020 
Tel: 29 SO 21 
Telex: 011-2156 
Cdile: BLUEFROST 
Hue Star Ltd. 
Sahas 

414/2 Vlr Savarkar Mvg 
PraUadevi 
Bombay 400 025 
Tel: 45 3% 87 
Telex: 011-4093 
Cable: FROSTBLUE 
Bhie Star Ltd. 
Band Box House 
Prabhadevi 
Boinbw400 025 
Tel: 45 73 01 
Telex: 01 1-3751 
CaMcBLlESTAR 
Bkia Star Ltd. 
Bhamletp 
Stadium Road 
Ah m adab a d 380 014 
Tel: 42880 
Telex: 234 
Cable: BLUEFROST 
Blue Star Lid. 
7Han Street 
P.O. Box 506 
Calcutia 700 001 
Tel: 23^131 
Telex: 021-76SS 
Cable: BLUESTAR 
Hue Star Lid. 
Nundari House 
7th &8thFk>or 
91 Nehru Place 
NawOalhl110 024 
Tel: 634770 & 635166 
Telex: (»1-2463 
Cable: BLUESTAR 



Blue Star Ltd. 

Hue Star House 

11/11AMagarathRoad 

Bangalore 560 025 

Tel:»668 

Telex: 043-430 

Cable: BLUESTAR 

Hue Star Ltd. 

Meeakshi Mandiram 

xxx/1678 Mahabna Gandhi Rd. 

Cochin 682 016 

Tel: 32069,32161,32282 

Telex: 0885-514 

Cable: BLUESTAR 

Hue Star Ltd. 

1-1-117/1 

Sarojini Devi Road 

Sacundarabad 500 003 

Tel: 70126, 70127 

Telex: 015-459 

Cable: BLUEFROST 

Hue Star Ltd. 

2/34 Kodambakkam High Road 

Madraa600 034 

Tel: 82056 

Telex: 041-379 

Cable: BLUESTAR 

INDONESIA 

BERCA Indonesia P.T. 
P.O. Box 496iJkt. 
Jn.Abdul Muis 62 
Jakarta 

Tel: 349255, 349886 
Telex: 46748 BERSIL lA 
Cable: BERSAL 
BERCA Indonesia P.T. 
P.O. Box 174/Sby. 
23 Jn. Jimerto 



ISRAEL 

Electronics Engineering Oiy. 

of Motorola Israel Ltd. 
16, KremenAki Street 
P.O.Box 25016 
Ta^AvIv 
Tel: 38973 
Telex: 33569, 34164 
Cable: BASTEL TeMviv 
JAPAN 

Yokagawa-HewMt-Packard LU. 
Chuo Hdg., 4th floor 
4-20, Nishinalaiima 5-chome 
Yodogawa-ku, Osaka-shi 
Oaaka,532 
Tel: 06-304-6021 
Telex: 523-3824 
Yokogawa-Hewlett-Packard LM. 
29-21. Takakki-Higashi 3-chome 
Suginami-tai, Tokyo 168 
Tel: 03-331-6111 
Telex: 232-2024 YHP-Tokyo 
Cable: YHPMARKET TDK 23 724 



Yokogawa-Hewlett-Packard Ltd. 
Nakamo Building 
24 Kami Sasajima-cho 
Nakamura-ku, Nagoya. 450 
Tel: 052 571-5171 
Yokogawa-Hewlett-Packard Ltd. 
Tanigawa Building 
2-24-1 Tsuruya-cho 
Kanagawa-ku 
Yokohama. 221 
Tel: 045-312-1252 
Telex: 382-3204 YHPYOK 
Yokogawa-Hewlett-Packard Ltd. 
Mito Mitsui Buikling 
105, 1-chome, San-no-maru 
MIto. Ibarigi 310 
Tel: 0292-25-7470 
Yokogawa-Hewlen-Packard Ltd. 
Inoue Buikling 
1348-3, Asahi-cho, 1-chome 
Ataugi, Kanagawa 243 
Tel: 0462-24-0452 
Yokogawa-Hewlett-Packard Ltd. 
Kumagaya Asahi 
Hachiiuni Building 
4th Root 
3-4, Tsukuba 
Kumagaya, Saitama 360 
Tel: 0485-24-6563 

KENYA 

Advanced Communicabons Ltd. 

P.O. Box 30070 

Nairobi 

Tel: 331955 

Telex: 22639 

Medical Only 

International AeradiojE.A. )Ltd. 

P.O. Box 19012 

Nairobi Airport 

Nairobi 

Tel: 336055/56 

Telex: 22201/22301 

Cable: INTAERIO Nairobi 

Medical Only 

Internabonal Aetadio (.A. ) Ltd. 

P.O. 80x95221 

Mombaaa 

KOREA 

Samsung Elecbonics Co., Ltd. 
15tti Floor, Daeyongak Hdg., 
25-5, 1-KA 
Choong Moo-Ro, Chung-Ku, 



MALAYSIA 

Hewlett-Packard Sales SDN BHD 
Suite 2.21/2.22 
Bangunan Angkasa Raya 
Jalan Ampang 
Kuala Lumpar 
Tel: 23320/27491 



P.O. 60X1917 
Lot 259, Satok Road 
Kuching, Sarawak 
Tel: 53544 
Cable: PROTELENG 

MOZAMBIQUE 

a:n. Goncalves. Ltd. 

162, rApt. 14 Av. D. Luis 

Caixa Postal 107 

Maputo 

Tel: 27091, 27114 

Telex: 6-203 NEGON Mo 

Cable: NEGON 

NEW GUINEA 

Hewlett-Packard Ausb^a 

Ply. Ltd. 
Devek>fxnent Bank Building 
Ground Floor 
Ward Strip 

Port Moraaby, Paupua 
Tel: 258933 
NEW ZEALAND 
Hewlett-Packard IN.Z.)Ltd. 
4-12 Cruickshank Street 
Kilbirnie, Wellington 3 
P.O. Box 9443 
Courtney Place 
Wellington 
Tel: 877-199 

Cable: HEWPACK Wellington 
Hewlett-Packard (J.Z.jLtd. 
Pakuranga Professional Centre 
267 Pakuranga Highway 
Box 51092 
Pakuranga 
Tel: 569-651 

Cable: HEWPACK Auckland 
Analytkal/Medical Only 
Medical Supplies N.Z. Ltd. 
Scientiiic Division 
79 Cartton Gore Road, Newmarket 
P.O. Box 1234 
Auckland 
Tel: 75-289 

Cable: DENTAL Auckteid 
Analytical/Medical Only 
Medical Supplies N.Z. Ltd. 
Norrie and Parumoana Streets 
Porlrua 
Tel:75<)9B 
Telex: 3858 
Analyfical/Medical Only 
Medical Supplies N.Z. Ltd. 
P.O. Box 309 
239 Sbnmore Road 
Chrlatchurch 
Tel: 892-019 

Cable: DENTAL Christchurch 
AnalytRal Medical Only 
Medical Supplies N.Z. LM. 
303 Great King Sfreat 
P.O. Box 233 
Ounadin 
Tel: 88-817 
Cable: DENTAL Dunedin 



NIGERIA 

The Electronics 
Instrumentatkms Ltd. 

N6B/770 Oyo Road 

Oluseun House 

P.M. 8. 5402 

Ibadan 

Tel: 461577 

Telex: 31231 TEIL NG 

Cable: THETIEL Ibadan 

The Electronics Instrumenta- 
tions Ltd. 

144 Agege Motor Road. Mushin 

P.O. Box 6645 

Lagos 

Cable: THETEIL Lagos 

PAKISTAN 

Mushko & Company Ltd. 

Oosman Chambers 

Abdullah Haroon Road 

Karachl-3 

Tel: 511027, 512927 

Telex ' 2894 

Cable': COOPERATOR Karachi 

Mushko & Company. Ltd. 

38B, Satellite Town 

Rawalpindi 

Tel:4lfe4 

Cable: FEMUS Rawalpindi 

PHIUPPINES 

The Online Advanced 

Systems Corporation 
Rico House 

Amorsoto cor. Herrera Sfr. 
Legaspi Village, Makati 
P.O. Box 1510 
Mefro Manila 

Tel: 85-35-81, 85-34-91,85-32-21 
Telex: 3274 ONLINE 



RHODESIA 

FieM Technical Sales 

45 Kehnn Road North 

P.O. Box 3458 

SaNabury 

Tel: 705231 (5 lines) 

Telex: RH 4122 

SINGAPORE 

HewMt-Packard Singapore 

(Pte.)Ltd. 
1150 Depot Road 
Alexandra P.O. Box 58 
Singapors4 
Tel: 270-2355 
Telex: HPSGRS 21486 
Cable: HEWPACK, Singapore 

SOUTH AFRICA 

Hewlett-Packard Soutt) Africa 

(Pty.l Ltd. 
Private Bag Wendywood, 
Sandton, Transvad, 2144 
Hewlett-Packard Centre 
Daphne Street, Wendywood, 
Sandton. 2144 
Tel:H)2-1040/8 
Telex: 8-4782 
Cable: HEWPACK Johannesburg 



Hewlett-Packard South Africa 

(Pty), Ltd. 
P.O. Box 120 

Howard Place, Cape Province, 7450 
Pine Park Centre, Forest Drive, 
Pinelands, Cape Province, 7405 
Tel; 53-7955 thu 9 
Telex: 57-0006 

SRI LANKA 

Metropolitan Agencies Ltd. 

209/9 Union Place 

Colombo 2 

Tel' 35947 

Telex: 1377METROLTD CE 

Cable: METROLTD 

SUDAN 

Radjson Trade 
P.O. Box 921 
Khartoum 

Tel: 44048 
Telex: 375 

TAIWAN 

Hewlett-Packard Far East Ltd. 

Taiwan Branch 

39 Chung Hsiao West Road 

Section 1 , 7th Floor 

Taipei 

Tel: 3819160-9,3141010 

Cable: HEWPACK TAIPEI 

Hewlett-Packard Far East Ltd. 

Taiwan Branch 

68-2. Chung Cheng 3rd. Road 

Kaohslung 

tel: (37)242318-Kaohsiung 

Analytical Only 

San Kwang Instruments Co., Ltd. 

20 Yung Sui Road 

Talpal 

Tel: 3615446-9 (4 tnes) 

Telex: 22894 SANKWANG 

Cable: SANKWANG Taipei 

TANZANIA 

Medical Only 

International Aeradio (E.A. ), Ltd. 

P.O. Box 861 

Dar ea Salaam 

Tel: 21251 Ext. 265 

Telex: 41030 

THAILAND 

UNIMESA Co. Ltd. 
Elcom Research BuNding 
2538 Sukumvit Ave. 
Bangchak.Bangkok 
Tel: 3932387, 3930338 
Cable: UNIMESA Bangkok 

UGANDA 

Medical Only 

International Aeradio(E A.), Ltd 

P.O. Box 2577 

Kampala 

Tel: 54388 

Cable: INTAERIO Kampala 

R.J. Tilbury (Zambia) Ltd. 

P.O. Box 2792 

Luaaka 

Tel' 73793 

Cable :ARJAYTEE, Lusaka 

OTHER AREAS NOT LISTED, 
CONTACT: 

Hewlett-Packard Intercontinental 

3200 HilKNew Ave. 

Pak) Alto, Cakfomia 94304 

Tel: (415)856-1501 

TWX: 91(5-373-1267 

Cable: HEWPACK Paki Alto 

Telex: 034-8300, 034-8493 













ONTARK) 

Hewlett-Packard (Cwada)Ltd. 
1020 Morrison Dr. 
Ottawa K2H8K7 






< 

Q 


ALBERTA 








Tel: 1613)820-6483 
TWX: 610-563-1636 






Hewlett-Packard (Canada) Ltd. 












11620A - 168th Sfreet 








Hewlett-Packard (Canada) Ltd 






< 


Edmonton T5M 3T9 








6877 Goreway Drive 






Tel: (403)452-3670 
TWX: 610-831-2431 








Tel: (416)678-9430 
TWX: 610-492-4246 


QUEBEC 




z 


BRITISH COLUMBU 


MANITOBA 


NOVA SCOTIA 


Hewlett-Packard (Canada) Ltd. 


FOR CANADIAN AREAS 


< 


Hewlett-Packard Canada) Ltd. 
210,7220 Fisher St. S.E. 


HewMt-Padord (Canada) Ud. 


Hewlett-Packard (Canada) Ltd. 


HewMt-Packanj (Canada) Ltd. 


275 Hymus Hvd. 


NOT USTED-. 


10691 SheM>ridge Vtay 
Rtehmond V8X 2W7 


380-550 Century St. 
WInnlpag R3H 0Y1 
Tel: p84)78S6701 
TWX: 610-671-3531 


800 Windmill Road 


Hewlett-Packard (Canada) Ltd. 


Pointe Claira H9R 1G7 


Contact Hewlett-Packard (Canada) 


o 


Calgary T2H 2H8 

Tel: (403)253-2713 


Dartmouth B3B 1L1 


552 Newbok] Street 


Tel: (514)697-4232 


Ltd. in Mississauga. 


Tel: (604)270-2277 
TWX: 61(5-925-5059 


Tel: p02) 469-7820 


London N6E2S5 


TWX: 610-422-3022 






Twx: 610-821-6141 


TWX: 610-271-4482 


Tel:ei9) 686-9181 


TU : 05-821 -521 HPCL 
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ARGENTINA 

Hewlett-Packard Argentina 

S.A. 

Av. Leandro N. Alem 822 - 12" 

1001 Buanoa Aire* 

Tel: 31-6063.4,5,6 

Telex: 122443 ARCIGY 

Cable: HEWPACKAR6 

Biotron S.A.C.I.y M. 

Bolivar 177 

1066 Buanoa Alraa 

Tel: 30-4846, 34-9356, 34-0460, 

33-2863 
Telex: 011-7595 
Cable: BkitronBaries 
BOLIVIA 
Casa Kavlin S.A. 
CallePotosi'1130 
P.O. Box 500 
La Paz 

Tel: 41530,53221 
Telex: CWC BX S298,in 3560082 
Cabte: KAVLIN 
BRAZIL 

Hewlett-Packard do Brasil 
I.e.C. Ltda. 

Alameda Rio Negro, 750 
Alphaville 

06400 Baruerl SP 
Tel: 429-3222 
Cable: HEWPACK Sao Paulo 



Hewlett-Packard do Brasil 
I.e.C. LUa. 
Rua Padre Chagas, 32 
90000-paito inmm 

Tel: (0512)22-2996.22-5621 
Cable: HEWPACK PeHo Alegre 
Hewlett-Packard do Brasil 
I.eC. Ltda. 

Av. Epitacio Pessoa. 4664 
Lagoa 

20000-Rlo da Janalr»4U 
Tel: 

Telex: 021-21905 HPBR-6R 
Cable: HEWPACK 
Rkide Jmeiro 

CHILE 

Jorge Calcagni y Cia. Ltda 
Vicuna MacKenna 3. Ofic. 1204 
Casila 16475 
Correo 9. Santiago 
Tel: 34152 
Telex: JCALCAGNI 



COLOMBIA 

Instrumentacidn 

Henrik A. Langebaek & Kier S.A. 

Carrera 7 No. 48-75 

Apartado A<reo 6287 

Bogota, I O.E. 

Tel: 269-8877 

Telex: 44400 

Cable: AARIS Bogota 

Instrumentadon 

H.A. Lanoebaek & Kier S.A. 

Carrera 63 No. 49-A-31 

Apartado 54098 

Madallin 

Tat: 304475 

COSTARICA 

CientiNGa Costarricense S.A. 

Avenida 2, Calle 5 

San Pedro de Monies de Oca 

Apartado 10159 

San Joaa 

Tel: 24-38-20, 24-08-19 

Telex: 2367 GALGURCR 

Cable: GALGUR 



ECUADOR 

Computadoras y Equipos 

Electrdnicos del Ecuador 

P.O. Box 6423 CCI 

Eloy Alfaro No. 1824,3°Piso 

Quito 

Tel: 453 482 

Tek!x:2548CYEDEED 

Cable: CYEDE-Quito 

Medical Only 

Hospitalar S.A. 

Casilla 3590 

Robles 625 

Quito 

Tel' 545-250 

Cable: HOSPITALAR-Quito 

EL SALVADOR 

IPESA 

Bulevar de los Heroes 11-48 

San Salvador 

Tel: 252787 

GUATEMALA 

IPESA 

Avenida Reforma 3-48, 

Zona 9 



mexk:o 

Hewlett-Packard Mexicana, 

S.A. de C.V. 

Av. Perifdrico Sur No. 6501 

Tepepan, Xochimiico 

Mexico 23, D.F. 

Tel: 905-676-4600 

Telex: 017-74-507 

Hewlett-Packard Mexicana, 

S.A. de C.V. 

Ave. Consbtuckjn No. 2184 

Montarray, N.L. 

Tel: 48-71-32, 48-71-84 

Telex: 038-410 

NICARAGUA 

Roberto Terdn G. 

Apartado Postal 689 

Edifick) Terjn 

Managua 

Tel: 25114, 23412,23454,22400 

Cable: ROTERAN Managua 

PANAMA 

Elech-dnkxi Balboa, S.A. 

Aparatado 4929 

Panama 5 

Calle Samuel Lewis 

Edificio "Alfa". No.2 

Cuidad da Panama 

Tel: 64-2700 

Telex: 3483103 Curundu, 

Canal Zone 
Cable: ELECTRON Panama 



PERU 

CompaAla Electro Mddica S.A. 

Los Flamencos 145 

San Isidro Casilla 1030 

Umal 

Tel: 41-4325 

Telex: Pub. Bootti 25424 SISIDRO 

Cable: ELMED Lima 

suriname 

Surtel Radio Holland N.V. 
Grote Hofstr. 3-5 
P.O. Box 155 
Paramaribo 
Tel: 72118, 77880 
Cable: Surtel 

TRINIDAD a TOBAGO 

CARTEL 

Caribbean Telecoms Ltd. 

P.O. Box 732 

69 Frederick Sbeet 

Port-o(-Spaln 

Tel: 62-53068 

URUGUAY 

Pablo Ferrando S.A.C.el 

Avenida Italia 2877 

CasiHa de Correo 370 

Montevideo 

Tel: 40-3102 

Telex: 702 Public Booth Para 

Pablo Ferrando 
Cable: RADIUM Montevideo 



VENEZUELA 

Hewlett-Packard de Venezuela 

CA. 

P.O. Box 50933 

Caracas 105 

Los Ruices Norte 

3a Transversal 

Edificio Segre 

Caracas 107 

Tel: 239-4133 (20 lines) 

Telex: 25146 HEWPACK 

Cable: HEWPACK Caracas 

FOR AREAS NOT USTED, 
CONTACT: 

Hewlett-Packard 
Inter-Americas 
3200 Hillview Ave 
Palo AHo. California 94304 
Tel: (415)856-1501 
TWX 910-373-1260 
Cable: HEWPACK Palo Alto 
Telex: 034-8300. 034-8493 
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AUSTRIA 

Hewlett-Packard Ges.m.b.H. 

Handelskai 52 

P.O. Box 7 

A-1205 Vienna 

Tel: 351621-27 

Cable: HEWPAK Vienna 

Telex: 75923 hewpak a 

BAHRAIN 

Medical Only 

Wael Pharmacy 

P.O. Box 648 

Bahrain 

Tel: 54886. 56123 

Telex : 8550 WAEL GJ 

Cable: WAELPHARM 

Analytical Only 

Al Hamidiya Trading 

and Contracting 

P.O. Box 20074 

Manama 

Tel: 259978, 259958 

Telex: 8895 KALDIAGJ 

BELGIUM 

Hewlett-Packard Benelux 
S.A./N.V. 

Avenue du Col-Vert, 1 , 
(Groenkraaglaan ) 
B-1170 Brussels 
Tel: (02)660 50 50 
Cable: PALOBEN Brussels 
Telex: 23-494 paloben bru 

CYPRUS 

Kypronics 

19 Gregorios Xenopoulos Street 

P.O. Box 1152 

Nicosia 

Tel: 45628/29 

Cable: Kypronics Pandehis 

Telex: 3018 

CZECHOSLOVAKIA 

Vyvojova a Provozni Zakladna 

Vyzkumnych Ustavu v Bechovicich 

CSSR-25097 Bechovlce u Prahy 

Tel: 89 93 41 

Telex: 12133 

institute of Medical Bionics 

Vyskumny Ustav Lekarskej Bioniky 

Jedlova 6 

CS-88346 

Bratislava-Kramare 

Tel: 4251 

Telex: 93229 

DDR 

EntwicMungslabor der TU Dresden 

Forschungsinstitut Meinsberg 

DDR-7305 

Waldheim/Meinsberg 

Tel: 37 667 

Telex: 518741 

Export Contact AG Zuerich 

Guenther Forgber 

Schlegelstrasse 15 

1040 Berlin 

Tel: 42-74-1 2 

Telex: 111889 

DENMARK 

Hewlett-Packard A;S 
Datavel 52 
OK-3460 Birkerod 
Tel: (02)81 66 40 
Cable: HEWPACK AS 
Telex: 37409 hpas dk 
Hewlett-Packard MS 
Navervej 1 

DK-8600 Sllkeborg 
Tel: (06)82 71 66 
Telex: 37409 hpas dk 
Cable: HEWPAISk AS 

EGYPT 

I.E.A. 

International Engineering Associates 

24 Hussein Hegazi Street 

Kasr-el-Aini 

Cairo 

Tel: 23 829 

Telex: 93830 

Cable: INTENGASSO 

SAMITRO 

Sami Amin Trading Office 

18 Abdel Aziz Gawish 

Abdine-Cairo 

Tel: 24932 

Cable: SAMITRO CAIRO 



FINLAND 

Hewlett-Packard OY 

Nahkahousunti 5 

P.O. Box 6 

SF-00211 Helsinki 21 

Tel: (90)6923031 

FRANCE 

Hewlett-Packard France 

Avenue des Tropiques 

Les Ulis 

Boite Postale No. 6 

91401 Orsay-Cedex 

Tel: (1)907 78 25 

TWX:600048F 

Hewlett-Packard France 

Chemin des Mouilles 

B.P. 162 

69130 Ecully 

Tel: (78)33 81 25. 

TWX:310617F 

Hewlett-Packard France 

P&icentre de la C^pi^e 

31081 Toulouse-Le Mirail 

Tel:(6114011 12 

TWX:510957F 

Hewlett-Packard France 

Le Ligoures 

Bureau de vente de Marseilles 

Place Rouft de VIKenueve 

13100 Aix-en-Provance 

Tel: (42)59 41 02 

Hewlett-Packard France 

2, Allee de la Bourgnette 

35100 Rennes 

Tel: (39)51 42 44 

TWX: 74091 2F 

Hewlett-Packard France 

16, rue du Canal de la Marne 

67300 Schiltlghelm 

Tel: (?8)83 08 10 

TWX:890141F 

Hewlett-Packard France 

Immeuble p^ricentre 

Rue van Gogh 

59650 Villeneuve D Ascq 

Tel: (20)91 41 25 

TWX:160124F 

Hewlett-Packard France 

Bureau de Vente 

Centre d' affaires Paris-Nord 

BStiment AmpSre 

Rue de la Commune de Paris 

B.P. 300 

93153 Le Blanc Mesnil CMex 

Tel: pi)931 88 50 

Hewlett-Packard France 

Av. du Pdt. Kennedy 

33700 Meriguac 

Tel: (56)97 22 69 

Hewlett-Packard France 

"France-Evry" immeuble Lorraine 

Boilevard de France 

91035 Evry-Cedex 

Tel: 077 96 60 

Hewlett-Packard France 

60, Rue de Metz 

57130 Jouy aux Arches 

Tel: (67)69 45 32 



GERMAN FEDERAL REPUBLIC 

Hewlett-Packard GmbH 
Vertriebszentrale Frankfurt 
Ssrner Strasse 117 
Postfach 560 140 
D-6000 Frankfurt 56 
Tel: (0611)50-04-1 
Cable: HEWPACKSA Frankfurt 
Telex: 04 13249 hpffmd 
Hewlett-Packard GmbH 
Technisches Bilro B5blingen 
Herrenberger Strasse 110 
D-7030 Bdblingen, Wurttemberg 
Tel: (0703)667-1 
Cable: HEWPACK Bbblingen 
Telex: 07265739 bbn 
Hewlett-Packard GmbH 
Technisches Buro Dijsseldorf 
Emanuel-Leutze-Str.l (Seestern) 
D-4000 Dusseldorf 
Tel: (0211)59711 
Telex: 085/86 533 hpddd 
Hewlett-Packard (JmbH 
Technisches Biiro Hamburg 
Wendenstrasse 23 
D-2000 Hamburg 1 
Tel: (040)24 13 93 



Cable: HEWPACKSA Hamburg 
Telex: 21 63 032 hphh d 
Hewlett-Packard GmbH 
Technisches Biiro Hannover 
Am Grossmarkf 6 
D-3000 Hannover 91 
Tel: (0511)46 60 01 
Telex: 092 3259 
Hewlett-Packard GmbH 
Technisches Buro Nilmberg 
Neumeyerstrasse 90 
D-8500Nurnberg 
Tel: P11)56 30 83 
Telex: 0623 860 
Hewlett-Packard GmbH 
Technisches Buro MiJnchen 
Eschenstrasse 5 
D-8021 Taufkirchen 
Tel: (089)6117-1 
Hewlett-Packard GmbH 
Technisches Buro Berlin 
Kaithstrasse 2-4 
D-1000 Berlin 30 
Tel: (030)24 90 86 
TelexIIIS 3405 hpbin d 

GREECE 

Kostas Karayannis 

8 Omirou Street 

Athens 133 

Tel: 32 30 303/32/37 731 

Analytical Only 

INTECO 

G. Papattianassiou & Co. 

17 Marni Street 

Athens 103 

Tel: 5522 915/5221 989 

Telex: 21 5329 INTE GR 

Cable: INTEKNIKA 

Medical Only 

Technomed Hellas Ltd. 

52 Skoufa Street 

Athens 135 

Tel: 3626 972 

HUNGARY 

MTA 

Milszerilgy is M«r^stechnikai 

Szolgalata 
Hewlett-Packard Service 
Lenin Krt. 67, P.O.Box 241 
1391 Budapest VI 
Tel: 42 03 38 
Telex: 22 51 14 



ICELAND 

Medical Only 

Elding Trading Company Inc. 

Hafnamvoli - Tryggvagfitu 

P.O.Box 895 

IS-ReykJavik 

Tel: 1 58 20/1 63 03 

Cable: ELDING Reykjavik 

IRAN 

Hewlett-Packard Iran Ltd. 
No. 13, Fourteenth St. 
Mir Emad Avenue 
P.O. 80x41/2419 
Tehran 
Tel: 851082-5 
Telex: 213405 hewp it 

IRELAND 

Hewlett-Packard Ltd. 

King Street Lane 

Winnersh, Wokingham 

Berks, RG11 5AR 

GB-England 

Tel: (0734)78 47 74 

Telex: 847178 

Cable: Hewpie London 

Hewlett-Packard Ltd. 

2C Avonbeg Industrial Estate 

Long Mile Road 

Dublin 12, Eire 

Tel: (01)514322 

Telex: 30439 

Medical Only 

Cardiac Services (Ireland) Ltd. 

Kilmore Road 

Artane 

Dublin 5, Eire 

Tel: (P1) 315820 

Medical Only 

Cardiac Services Co. 

95A Finaahy Rd. Soutti 

Belfast BT10 OBY 

GB-Northern Ireland 



ITALY 

Hewlett-Packard Italiana S.p.A. 
Via G.Di Vittorio . 9 
20063 Cernusco 

Sul Naviglio (Ml ) 
Tel; (2)903691 
Telex: 311046 HEWPACKIT 
Hewlett-Packard Italiana S.p.A. 
Via Turazza , 14 
35100 Padova 
Tel; (49)664888 
Telex: 41612 HEWPACKI 
Hewlett-Packard Italiana S.p.A. 
Via G. Armellini 10 
1-00143 Roma 
Tel: (06)54 69 61 
Telex: 61514 

Cable: HEWPACKIT Roma 
Hewlett-Packard Italiana S.p.A. 
Corso Giovanni Lanza 94 
1-10133 Torino 
Tel;(011) 682245/659308 
Medical/Calculators Only 
Hewlett-Packard Italiana S.p.A. 
Via Principe Nicola 43 G/C 
1-95126 Catania 
Tel:|095)37 05 04 
Hewlett-Packard Italiana S.p.A. 
Via Nuova San Rocco A. 

Capodimonte, 62A 
1-80131 NapoH 
Tel: (081)7913544 
Hewlett-Packard Italiana S.p.A. 
Via E. Masi, 9/6 
U0137 Bologna 
Tel: (051)307887/300040 

JORDAN 

Mouasher Cousins Cki. 

P.O. Box 1387 

Amman 

Tel: 24907/39907 

Telex: SABCO JO 1456 

Cable: MOUASHERCO 

KUWAIT 

Al-Khaldiya Trading & 

Contractino 
P.O. Box 830-Safat 
Kuwait 
Tel:42 4910/41 1726 

LUXEMBURG 

Hewlett-Packard Benelux 
S.A./N.V. 

Avenue du Col-Veft, 1 
(Groenkraaglaan) 
B-1170 Brussels 
Tel: (02) 672 22 40 
Cable: PALOBEN Brussels 
Telex; 23 494 

MOROCCO 

Dolbeau 

81 rue KaratchI 

Casablanca 

Tel: 3041 82 

Telex: 23051/22822 

Cable: MATERIO 

Gerep 

3, rued'Agadir 

Casablanca 

Tel: 272093/5 

Telex; 23739 

Cable: GEREP-CASA 

Cogedir 

31 rue Omar Slaoui 

Casablanca 

Tel; 27 65 40 

Telex: 21737/23003 

Cable: COGEDIR 

NETHERLANDS 

Hewlett-Packard Benelux N.V. 
Van Heuven Goedhartlaan 121 
P.O. Box 667 
NL-Amstelveen 1134 
Tel: (D20)47 20 21 



NORWAY 

Hewlett-Packard Norge A/S 
Osterdalen 18 
P.O. Box 34 
1345 Osteraas 
Tel; (02) 1711 80 
Telex; 16621 hpnas n 
Hewlett-Packard Norge A/S 
Nygaardsgaten 114 
5000 Bergen 



POLAND 

Biuro Informacji Technicznej 

Hewlett-Packard 

Ul Stawki 2. 6P 

00-950 Warszawa 

Tel: 33.25.88/39.67.43 

Telex; 81 24 53 hepa pi 

UNIPAN 

Biuro Obslugi Technicznej 

01-447 Warszawa 

ul Netralska 6 

Poland 

Zaklady Naprawcze Sprzetu 

Medycznego 
Plac Komuny Paryskiej 6 
90-007 Lddi 
Tel; 334-41, 337-83 
Telex; 886981 

PORTUGAL 

Telectra-Empresa Tunica de 

Equipamentos ElMricos S.a.r.l. 

Rua Rodrigo da Fonseca 103 

P.O. Box 2531 

P-Llsbon 1 

Tel: (19)68 60 72 

Cable: TELECTRA Lisbon 

Telex: 12598 

Medical only 

Mundinter 

Intercambio Mundial de Com<rcio 

S.a.r.l. 

P.O. Box 2761 

Avenida Antonio Augusto 

de Aguiar 138 
P - Lisbon 
Tel; (19)53 2131/7 
Telex; 16691 munter p 
Cable; INTERCAMBIO Usbon 

QATAR 

Nasser Trading & Contracting 

P.O. Box 1563 

Doha 

Tel; 22170 

Telex; 4439 NASSER 

Cable; NASSER 

RUMANIA 

Hewlett-Packard Reprezentanta 

Bd.n. Baicescu 16 

BucuresU 

Tel; 15 80 23/13 88 85 

Telex; 10440 

l.l.R.U.C. 

Intreprinderea Pentru 

Intretinerea 
Si Repararea Utilajelor de Calcul 
B-dul Prof. Oimitrie Pompei 6 
Bucurestl-Sectorul 2 
Tel: 88-20-70, 88-24-40, 88-67-95 
Telex; 118 

SAUDI ARABIA 

Modern Electronic 

Establishment (Head Office) 

P.O. Box 1228, Baghdadiah Street 

Jeddah 

Tel; 27 798 

Telex; 40035 

Cable; ELECTA JEDDAH 

Modem Electronic 

Establishment (Branch) 

P.O. Box 2728 

Riyadh 

Tel; 62596*6232 

Cable :RAOUFCO 

Modem Electronk; 

Establishment branch) 

P.O. Box 193 

Al-Khobar 

Tel: 44678-44813 



SPAIN 

Hewlett-Packard Espafiola, S.A. 

Calle Jerez 3 

E-Madrld 16 

Tel; (1)458 26 00 (10 lines) 

Telex; 23515 hpe 

Hewlett-Packard Espadliola S.A. 

Colonia Mirasierra 

Edificio Juban 

% Costa Brava, 13 

Madrid 34 

Hewlett-Packard Espai^ola, S.A. 

Milanesado 21-23 

E-Barcelona 17 

Tel; (3)203 6200 (5 lines) 



Hewlett-Packard Esparioia, S.A. 
Av Ramdn y Cajal, 1 
Edificio Sevilla, planta 9 * 
-Seville 5 
Tel; 54 44 54/58 
Hewlett-Packard Espaftola S.A. 
Edificio Albla II 7° B 
E-BittMO 1 

Tel; 23 83 06/23 82 06 
Hewlett-Packard Espanola S.A. 
C/Ramon Gordillo 1 

(Entlo. ) 
E-Valencia-10 
Tel; 95-361.13.54,361.13.58 

SWEDEN 

Hewlett-Packard Sverlge AB 
EnighetsvSgen 3. Fack 
S-161 Bromma20 
Tel: (08)730 05 50 
Telex; 10721 
Cable; MEASUREMENTS 

Stockholm 
Hewlett-Packard Sverige AB 
FriStallsgatan 30 
S-421 32 Vdstra Fr<Slunda 
Tel: (031)49 09 50 
Telex: 10721 via Bromma office 
SWITZERLAND 
Hewlett-Packard @chweiz)AG 
Zurcherstrasse 20 
P.O. Box 307 

CH-8952 Schlieren-Zurich 
Tel; (01)7305240 
Telex; 53933 hpag ch 
Cable; HPAG CH 
Hewlett-Packard (Schweiz)AG 
Chateau Bloc 19 
CH-1219 Le LIgnon-Qeneva 
Tel; (022)96 03 22 
Telex; 27333 hpag ch 
Cable: HEWPACKAG Geneva 

SYRIA 

General Electronic Inc. 

Nuri Basha-Ahnaf Ebn Kays Street 

P.O. Box 5781 

Damascus 

Tel; 33 24 87 

Telex: 11215 ITIKAL 

Cable; ELECTROBOR DAMASCUS 

Medical/Personal Cak;ulator only 

Sawah & Co. 

Place Azm^ 

B.P. 2308 

Damascus 

Tel; 16 367-19 597-14 268 

Suleiman Hilal El Mlawi 

P.O. Box 2528 

Mamoun Bitar Street, 56-58 

DamascusTel;11 46 63 



TUNISIA 

Tunisie Electronique 

31 Avenue de la Liberie 

Tunis 

Tel: 280 144 

Coreina 

1 ter. Av. de Carthage 

Tunis 

Tel; 253 821 

Telex; 12319 CABAM TN 

TURKEY 

TEKNIM Company Ltd. 

Riza Sah Pehlevi 

CaddesI No. 7 

Kavaklidere. Ankara 

Tel: 275800 

Telex; 42155 

Teknim Com. , Ltd. 

Barbaros Bulvari 55/12 

Besikyas, Istanbul 

Tel; 613 546 

Telex; 23540 

Medical only 

E.M.A. 

Muhendislik Kollektif Sirketi 

Mediha Eldem Sokak41/6 

Yijksel Caddesi 

Ankara 

Tel: 17 56 22 

Cable; EMATRADE/Ankara 

Analytical only 

Yilmaz Ozyurek 

Milli Mudafaa Cad 16« 

Kizilay 



Ankara 

Tel: 25 03 09- 17 80 26 
Telex: 42576 OZEKTR 
Cable: OZYUREK ANKARA 

UNITED ARAB EMIRATES 

Emitac Ltd. (Head Office) 

P.O. Box 1641 

Sharjah 

Tel; 354121/3 

Telex; 8136 

Emitac Ltd. (Branch Office) 

P.O. Box 2711 

Ahu Ohabt 

Tel; 331370/1 

UNITED KINGDOM 

Hewlett-Packard Ltd. 
King Street Lane 
Winnersh, Wokingham 
Berks. RG11 5AR 
Tel: (0734)784774 
Telex S471 78/9 
Hewlett-Packard Ltd. 
Trafalgar House 
Navigation Road 
Altrincham 
Cheshire WA14 1NU 
Tel: (061)928 6422 
Telex; 668068 
Hewlett-Packard Ltd. 
Lygon Court 
Hereward Rise 
Dudley Road 
Halesonven. 
West Midlands B62 BSD 
Tel; P21) 550 9911 
Telex: 339105 
Hewlett-Packard Ltd. 
Wedge House 
799, London Road 
Thornton Heath 
Surrey CR4 6XL 
Tel: pi) 6840103 
Telex: 946825 
Hewlett-Packard Ltd 
10, Wesley St. 
Castleford 
Ynrls WFin 1AF 
Tel; (0977)550016 
Telex: 557355 
Hewlett-Packard Ltd 
1, Wallace Way 
HItchin 

Herttordshire, SG4 OSE 
Tel: (0462)31111 
Telex; 82.59.81 

USSR 

Hewlett-Packard 
Representative Office USSR 
Pokrovsky Boulevard 4/17-kw 12 
Moscow 101000 
Tel; 294.20.24 
Telex; 7825 hewpak su 

YUGOSLAVIA 

Iskra-Standard /Hewlett-Packard 
Miklosiceva 38A/II 
61(U0 Ljubljana 
Tel; 31 58 7gi32 16 74 

SOCIAUST COUNTRIES 
NOT SHOWN PLEASE 
CONTACT: 

Hewlett-Packard Ges.m.b.H 

Handelskai 52 

P.O. Box 7 

A-1205 Vienna, Austria 

Tel: (0222)35 16 2110 27 

MEDITERRANEAN AND 
MIDDLE EAST COUNTRIES 
NOT SHOWN PLEASE 
CONTACT: 

Hewlett-Packard S.A. 
Mediterranean and Middle 
East Operafions 
35, Kolokotroni Street 
PlatIa Kefallariou 
GR-Kifissia-Athens, Greece 
Tel: 8080337/259/429 

FOR OTHER AREAS 
NOT LISTED CONTACT 

Hewlett-Packard S.A. 

7, rue du Bois-du-Lan 

P.O. Box 

CH-1217 Meyrin 2 - Geneva 

Switzerland 

Tel; (022) 82 70 00 
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ALABAMA 

P.O. Box 4207 
8290 Whitesburg Dr. 
Huntsville 35802 
Tel; (205)881-4591 
8933 E. Roebuck Blvd. 
Birmingham 35206 
Tel: (205)836-2203/2 

ARIZONA 

2336 E. Magnolia St. 
Phoenix 85034 
Tel: (602)244-1361 
2424 East Aragon Rd. 
Tucson 85706 
Tel: (602)889-4661 

'ARKANSAS 

Medical Service Only 
P.O. Box 5646 
Brady Station 
Little .Rock 72215 

Tel: (501)376-1844 

CALIFORNIA 

1579 W. Shaw Ave. 
Fresno 93771 
Tel: (209)224-0582 
1430 East Orangethorpe Ave. 
Fullerton 92631 
Tel: (714)870-1000 
3939 Lankershim Boulevard 
North Hollywood 91604 
Tel: (213)877-1282 
TWX: 910-499-2671 
5400 West Rosecrans Blvd. 
P.O. Box 92105 
World Way Postal Center 
Los Angeles 90009 
Tel: (213)776-7500 
TWX:91()-325-6608 
'Los Angeles 
Tel: {213)776-7500 
3003 Scott Boulevard 
Santa Clara 95050 
Tel: (408)988-7000 
'Ridgecrest 
Tel: (714)446-6165 
646 W. North Market Blvd 
Sacramento 95834 
Tel: (916)929-7222 



9606 Aero Drive 

P.O. Box 23333 

San Diego 92123 

Tel; (714)279-3200 

'Tarzana 

Tel: (213)705-3344 

COLORADO 

5600 DTC Parkway 
Englewood 80110 

Tel: (303)771-3455 

CONNECTICUT 

12 Lunar Drive 
New Haven 06525 
Tel: (203)389-6551 
TWX: 710-465-2029 

FLORIDA 

P.O. Box 24210 
2727 N.W. 62nd Street 
Ft. Lauderdale 33309 
Tel; (305)973-2600 
4428 Emerson Street 
Unit 103 

Jacksonville 32207 
Tel: (904)725-6333 
P.O. Box 13910 
6177 Lake Ellenor Dr. 
Orlando 32809 
Tel: (305)859-2900 
P.O. Box.12826 
Suite 5, Bldg. 1 
Office Park North 
Pensacola 32575 
Tel: (904)476-8422 

GEORGIA 

P.O. Box 105005 

450 Interstate North Parkway 

Atlanta 30348 

Tel: (404)955-1500 

Medical Service Only 

'Augusta 30903 

Tel; K04) 736-0592 

P.O. Box 2103 

1172 N. Davis Drive 

Warner Robins 31098 

Tel: (912)922-0449 

HAWAII 

2875 So. King Street 
Honolulu 96826 
Tel; (808)955-4455 



ILLINOIS 

5201 Tollview Dr. 
Rolling Meadows 60008 
Tel: (312)255-9800 
TWX: 910-687-2260 

INDIANA 

7301 North Shadeland Ave. 

Indianapolis46250 

Tel: (317)842-1000 

TWX: 81(5-260-1797 

IOWA 

2415 Heinz Road 

Iowa City 52240 

Tel: (319)338-9466 

KENTUCKY 

Medical Only 

3901 Atkinson Dr. 

Suite 407 Atkinson Square 

Louisville 40218 

Tel: (502)456-1573 

LOUISIANA 

P.O. Box 1449 
3229-39 Williams Boulevard 
Kenner 70063 
Tel: (504)443-6201 

MARYLAND 

7121 Standard Drive 
Parkway Industrial Center 
Hanover 21076 
Tel: (301)796-7700 
TWX; 710-862-1943 
2 Choke Cherry Road 
Rockvllle 20850 
Tel: (301)948-6370 
TWX: 710-828-9684 

MASSACHUSETTS 

32 Hartwell Ave. 
Lexington 02173 
Tel: (BU 1861-8960 
TWX: 710-326-6904 

MICHIGAN 

23855 Research Drive 
Farmington Hills 48024 
Tel; 013)476-6400 
724 West Centre Ave. 
Kalamazoo 49002 
Tel. (606)323-8362 



MINNESOTA 

2400 N. Prior Ave. 
St. Paul 55113 
Tel: (612)636-0700 

MISSISSIPPI 

322 N. Mart Plaza 
Jackson 39206 

Tel: pi) 982-9363 

MISSOURI 

11131 Colorado Ave. 
Kansas City 64137 
Tel: (816)763-8000 
TWX: 91(1-771-2087 

1024 Executive Parkway 
St. Louis 63141 
Tel; (314)878-0200 

NEBRASKA 

Medical Only 
7101 Mercy (load 
Suite 101 
Omaha 68106 
Tel; (402)392-0948 

NEVADA 
'Las Vegas 

Tel: (702)736-6610 

NEW JERSEY 

W. 120 Century Rd. 
Paramus 07652 
Tel: (201)265-5000 
TWX; 710-990-4951 
Crystal Brook Professional 

Building, Route 35 
Eatontown 07724 
Tel;(201) 542-1384 

NEW MEXICO 

P.O. Box 11634 
Station E 

11300 Lomas Blvd., N.E. 
Albuquerque 87123 
Tel: (505)292-1330 
TWX: 910-989-1185 
156 W/yatt Drive 
Las Cruces 88001 
Tel: (505)526-2484 
TWX: 910-9983-0550 



NEW YORK 

6 Automation Lane 
Computer Park 
Albany 12205 
Tel; (518)458-1550 
TWX; 710-444-4961 
650 Perinton Hill Office Park 
Fairport 14450 
Tel; {716)223-9950 
TWX: 510-253-0092 
No.1 Pennsylvania Plaza 
55tti floor 

34th street & 8th Avenue 
New York 10001 
Tel; (212)971-0800 
5858 East Molloy Road 
Syracuse 13211 
Tel: (315)455-2486 
1 Crossways Park West 
Woodbury 11797 
Tel; (516)921-0300 
NORTH CAROLINA 
5605 Roanne Way 
Greensboro 27405 
Tel: (919)852-1800 

OHIO 

Medical/Computer Only 
Bldg. 300 

1313 E. Kemper Rd. 
Cincinnati 45426 
Tel: (513)671-7400 
16500 Sprague Road 
Cisvsland 44130 
Tel: (216)243-7300 
TWX:81(i-423-9430 
330 Progress Rd. 
Dayton 45449 
Tel; (513)859-8202 
1041 Kingsmill Parkway 
Columbus 43229 
Tel; (614)436-1041 
OKLAHOMA 
P.O. Box 32008 
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Your Comments, Please... 

Your comments assist us in improving 
the usefulness of our publications; they 
are an important part of the inputs used 
in preparing updates to the publica- 
tions. 

Please complete the questionnaire, fold 
it up and return it to us. Feel free to 
mark more than one box to a question 
and to make any additional comments. 
If you prefer not to give us your name 
just leave the last part, name and ad- 
dress, blank. All comments and sugges- 
tions become the property of HP. 



1. Did you have any difficulty in understanding or applying the material presented in 
this manual? 

D None D Minimal Difficulty D Difficulty D Considerable Difficulty 
If so: 

a. What were the "difficult" areas? 

n Indexing? D Omitted information? 

D Organization? D Examples 

D Depth of coverage? D Other (Please explain) 

b. What do you suggest we can do to clarify these areas? 



Z. What was your level of programming knowledge before you started using this 
manual? 

n None D Beginner D Intermediate D Expert 

3. What is your major application of the equipment described in this manual? 

D Business Administration D Education 

D General Computation and Data Analysis D Data Acquisition and Control 

D Engineering D Medicine 

What kind? What kind? 



D Interfacina D Other (Please name) 



4. What best describes your level of involvement with the equipment? 

D Run programs written by others □ Write complex programs 

D Write simple programs □ Hobbyist 

D Do simple calculations □ Other 

D Do applications programming 

5. What type of binding would be best for your particular use? 

D Single pages in looseleaf binders D Glued spine 

D Spiral or wire-o binding D Other (Please specify) 

General Comments: 



Name: 



Address: 



Thank you for your help. No postage necessary if mailed in the U.S.A. 

noQQc onna-j February 1, 1979 
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A^TN: CON'^ROLLER DOCUMENTATION 



Assembly Language ROM Errors 

Improper argument in OCTAL or DECIMAL function 

Break Table overflow 

Undefined BASIC label or subprogram, name used in IBREAK statement 

Attempt to write into protected memory; or, attempt to execute instruction not 
in ICOM region 

Label used in an assembled location not found 

Doubly-defined entry point or routine 

Missing ICOM statement 

Module not found 

Errors in assembly 

Attempt to move or delete module containing an active interrupt service 
routine 

Address out of range in IDUMP statement 

Routine not found 

Unsatisfied externals 

Missing COM statement 

BASIC'S common area does not correspond to assembly module requirements 

Insufficient number of BASIC COM items 

Assembly-Time Errors 

Doubly-defined label 

END instruction missing; or module name does not match 

Expression evaluation error 

Literal pools full or out of range 

ICOM region overflow 

Operand out of range 

Argument declaration pseudo-instruction out of sequence 

Incorrect type of operand used 

Undefined symbol 
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